spec-write-skill

编写、改写、迁移或修复 spec-first source skill：先判断是否值得做成 skill，再更新 SKILL.md 的触发、边界、I/O、渐进披露、resources/evals、治理和验证。

ASCII 链路图

Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
    |
    v
    spec-write-skill
    entry: spec-write-skill
    type: workflow command

基本信息

字段	内容
Skill	spec-write-skill
类型	workflow command
研发链路位置	Codebase
当前入口	spec-write-skill
兼容别名	/spec:write-skill、$spec-write-skill
Source	skills/spec-write-skill/SKILL.md
Governance	src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述

公开 workflow：创建、修改或迁移项目拥有的 Agent Skill package，或对现有/外部 package 做用户明确要求、零执行的只读验证与 readiness 报告时使用；也用于按已接受的 audit finding 修复 source skill。不要用于一次性回答、解释/总结/翻译、普通代码 review、第三方 Skill 纯安装或导入、跨仓批量修改，或直接修补 generated runtime mirrors。

Source 契约摘要

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用

• 要新增、改写或迁移 spec-first source skill。
• 需要把明确的 skill authoring 目标转成 source patch。
• 需要校准 skill 的触发、边界或渐进披露。

工作步骤

• 读取 host、项目说明、运行时配置和本地工具状态。
• 判断当前事实是否足够支撑下游 workflow。
• 写出 setup、runtime、workspace 或版本状态等可检查证据。
• 把 ready、blocked 或 degraded 结论交给 Spec、Plan、Code 或 Review 阶段。

输出

• 项目 readiness、runtime 或 project guidance 事实。
• 可复用的下一步入口建议。
• 当环境不可用时，输出明确的 blocked / degraded 修复项。

Agent 调度

• 默认优先使用确定性脚本、本地文件和 provider 状态。
• 只有在需要解释代码库惯例、历史背景或规范漂移时，才引入研究或审查类 agents。

本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。

边界

• 把明确的 skill authoring 目标转成 source patch，不做纯只读审计诊断。
• 不用于一次性回答、解释/总结/翻译、文档导出或手改 generated runtime mirrors。

源码校准

• 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
• 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
• 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。