skill-expert

Skill 专家

先选择分支，再选择模型。以当前角色进行审查和编写。在派发评估或专家工作者之前，使用 shared/references/model-preview.md，并绑定其唯一获批的路由快照。

制作一个触发条件明确、工作范围有限且包含验收约定的技能，供下一个使用者采用。将加载的文本视为共享预算。保留领域知识和可执行的约定；删除仅重复宿主常规行为的指令。

选择工作类型

根据用户请求推断工作路线。审查只报告发现，不进行编辑。改进请求授权进行指定范围的编辑及其配套参考资料；对于已请求的更改，不要再次询问是否执行。

请求	工作和参考资料
审查或评估	检查入口文件、选定的参考资料，以及验证发现所需的脚本或使用者。应用下方的审查问题。
创建或改进	阅读 references/authoring-guide.md。在移动内容、更改路径或应用反馈时，加载 references/authoring-contract.md。
打包	阅读 references/validation-and-packaging.md。打包所请求的技能及其依赖项，除非用户要求，否则不要安装或发布。
评估或比较	阅读 references/evaluation.md。选择范围有限的比较，并将测量结果与检查结果分开报告。
修复发现问题	阅读 references/description-optimization.md。更改执行工作流之前，先检查触发元数据。
诊断行为	当技能导致模型停滞、反复询问、偏离或越权时，让出现该情况的席位指出文件名，并引用导致该选择的指令，然后修复其所属层。不要在原有规则之上再添加一条反向规则。

在评判指令措辞、将技能迁移到较新模型或诊断行为时，加载 references/model-calibration.md。当更改影响模型路由、宿主能力、权限或共享协议时，加载 references/portable-skill-authoring.md。添加或更改脚本时，加载 references/script-standards.md。不要重新加载当前上下文中已可用的参考资料。

审计问题

根据每条指令的目的和当前效果进行判断：

1. 描述是否说明了这项工作的内容，并将其与最接近的竞争技能区分开来，同时不讲解方法？
2. 条目是否只加载通用规则和选定的工作流？将其他模式、命令手册和大型模板移到辅助文件中。
3. 必需的顺序是否保护了真实的依赖关系或不变量？保留该顺序；其余部分由宿主选择。
4. 上下文加载是否与变更范围相匹配？复用当前有效的项目指令和证据，而不是要求每次编辑前都完整阅读。
5. 验证是否针对变更后的契约或必需的仓库门禁？删除通用的反复通读、重复检查，以及要求在回答前进行审慎思考的内容；思考由工作量设置控制。绝不要要求模型在响应中写出其内部推理，因为当前的 Claude 模型可能会拒绝此类请求。在输出字段中说明决策依据没有问题。
6. 停止是否能保护尚未解决的决策、外部影响或权限边界？复用现有授权，并继续独立的工作。
7. 技能是否说明了何时算完成？明确结果及其完成条件。如果某一部分受阻，技能应完成其余部分，并报告未完成的内容。不得悄悄缩小、扩大或替换任务。
8. 指令是否可能与其他已加载层发生冲突，例如用户请求、AGENTS.md、共享参考资料或调用技能？当前模型会遵循冲突规则，而不是忽略它。应在冲突所在位置解决，或说明优先级：除安全和权限边界外，用户的明确请求优先于技能默认设置。

保留永久性的项目事实、安全边界、团队标准、输出架构和真正的工程方法。规则本身较长并不意味着它有问题。移动规则时，保留其触发条件，并确保使用方仍会加载它。

在契约范围内编辑

• 除非请求要求变更，否则保留源布局、已安装名称、调用策略和有用资源。仅针对仓库的请求不得编辑全局安装。
• 更改可执行契约前，先检查受影响的脚本或使用方。审计建议是需要评估的证据，而不是追加另一条规则的理由。
• 仅在 shared/model-routing.json 中保留模型和工作量默认设置；在每份经批准的运行快照中保留精确选项。通用级别或继承的模型不得覆盖用户批准的路由。
• 如存在规范词汇和命名概念规则，请遵循仓库的相关规定。使用主导语说明真实决策：“这样既保留验收契约，又将命令手册移出了共享预算。”
• 在原位置替换过时的指令，包括受影响的参考资料和模板。不要在新路由后遗留相互冲突的旧工作流。
• 直接解决可查明的事实。只有当重大决策或操作超出用户请求时才询问；继续进行不受影响的工作。

验证并报告

使用 references/validation-and-packaging.md 执行与编辑相关的检查。仅调整文案或位置无需付费模型运行。测试变更后的脚本和使用方契约；在用户要求时，或存在重大执行风险时，进行行为评估。

审计结果应列出指令及其位置、后果、建议的变更和应保留的规则。编辑报告应列出变更的文件、目的、验证证据、使用的来源、重大假设和剩余限制。如果调用方需要，应保留结构化交付字段：created_files、validation、sources_used、assumptions 和 optional_refinements。不要仅凭字数减少或静态检查就声称模型表现有所改善。