skill-writer

技能编写器

在遵循目标仓库当前说明的前提下，使用此工作流创建和改进技能。 主要成功条件：在开始编写前，最大限度地覆盖高价值输入，让最终技能尽可能少有盲点。

仅加载任务所需的路径：

任务	阅读
设置技能类别和必需维度	references/mode-selection.md
应用深度与简洁性方面的写作约束	references/design-principles.md
为此技能选择结构模式	references/skill-patterns.md
为流程繁重的技能选择工作流编排模式	references/workflow-patterns.md
为确定性质量选择输出格式模式	references/output-patterns.md
选择工作流路径和必需输出	references/mode-selection.md
加载按技能类型划分的代表性综合示例	references/examples/*.md
按深度门槛综合外部和本地来源	references/synthesis-path.md
编写或更新 SKILL.md 及辅助文件	references/authoring-path.md
优化技能描述和触发精度	references/description-optimization.md
使用正面/负面/修正示例进行迭代	references/iteration-path.md
评估行为并比较基线与启用技能后的表现（可选量化）	references/evaluation-path.md
注册并验证技能变更	references/registration-validation.md

步骤 1：确定目标和路径

1. 确定目标技能路径和预期操作（create、update、synthesize、iterate）。
2. 阅读 references/mode-selection.md 并选择所需路径。
3. 对技能进行分类（workflow-process、integration-documentation、security-review、skill-authoring、generic）。
4. 如果类别或深度要求不明确，就提出一个直接问题；否则说明明确的假设。

步骤 2：按需执行综合

阅读 references/synthesis-path.md。

1. 收集并评估相关来源，记录来源出处。
2. 引入外部内容时，应用信任和安全规则。
3. 生成有来源依据的决策，并报告覆盖情况和缺口状态。
4. 如果技能属于混合类型，从 references/examples/*.md 加载一个或多个配置文件。
5. 记录实际技能所需的主要来源集；不要暗示存在固定的外部来源集。
6. 在进入编写阶段前，满足深度门槛。

步骤 3：如果要根据结果/示例进行改进，先执行迭代

如果所选路径包含 iteration（例如操作为 iterate），请先阅读 references/iteration-path.md。

1. 收集示例并匿名化，同时记录来源出处。
2. 根据工作切片和保留切片重新评估技能行为。
3. 根据正面/负面/修正证据提出改进建议。
4. 将具体的行为变化纳入编写工作。

如果所选路径不包含 iteration，则跳过此步骤。

步骤 4：编写或更新技能文件

阅读 references/authoring-path.md。

1. 使用祈使语气编写或更新 SKILL.md，并加入有助于触发的描述。
2. 只有在确有必要时，才创建精简的参考文件和脚本。
3. 遵循 references/skill-patterns.md、references/workflow-patterns.md 和 references/output-patterns.md 中的结构和输出确定性要求。
4. 对于编写/生成器类技能，请在参考资料中加入转换后的示例：
   • 正常流程
   • 安全/健壮变体
   • 反模式及其修正版本

步骤 5：优化描述质量

阅读 references/description-optimization.md。

1. 验证应触发和不应触发的查询集。
2. 通过针对性的描述修改减少误报和漏报。
3. 让触发语句对 Codex 和 Claude 都保持通用。

步骤 6：评估结果

阅读 references/evaluation-path.md。

1. 默认进行轻量级定性检查（推荐）。
2. 对于集成、文档和技能编写类技能，请加入 references/evaluation-path.md 中简洁的深度评估标准。
3. 仅在收到请求或风险需要时，运行更深入的评估流程，以及定量的基线与使用技能后的对比。
4. 记录结果和未解决的风险。

步骤 7：注册并验证

阅读 references/registration-validation.md。

1. 执行仓库注册步骤。
2. 使用严格的深度门槛进行快速验证。
3. 拒绝未达到深度门槛或未通过必需产物检查的浅层输出。

输出格式

返回：

1. Summary
2. Changes Made
3. Validation Results
4. Open Gaps

适用场景

用于创建可复用的技能、更新现有技能、将源材料整合为技能，或根据观察到的结果进行迭代。不要用它来安装现有技能，也不要为一次性任务进行不必要的编写。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。