1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | create-specification-github-awesome-copilot |
| 作者/维护者 | github/awesome-copilot 社区合集（该子技能对应的前身 prompt 文件由贡献者 Daniel Scott-Raynsford 于 2025-07-07 提交，此后经多位独立贡献者持续修订） |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/create-specification |
| 许可证 | MIT（数据来自 GitHub API，仓库级） |
| GitHub Stars / Forks | 39,321 / 5,002（数据来自 GitHub API；为合集仓库整体数字，不代表本技能自身热度） |
| 最新版本 | 无独立版本号，随仓库滚动更新；最近一次针对本技能的改动为 2026-08-07 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill create-specification，或将 skills/create-specification 目录复制进 agent 的 skills 目录 |
2. 功能介绍与亮点
帮助用户在动手写代码之前，先产出一份结构清晰、机器可读的规格文档。技能给出一份固定模板，涵盖引言、目的与范围、术语定义、需求/约束/准则（分别用 REQ-/CON-/GUD- 等前缀编号）、接口与数据契约、验收标准（Given-When-Then 格式）、测试自动化策略、依赖与外部集成、示例与边界情况、校验标准、关联文档等十一个板块，并规定规格文件必须存入 /spec/ 目录、按 spec-[a-z0-9-]+.md 命名、以 schema/tool/data/infrastructure/process/architecture/design 之一作为主题前缀。
亮点在于它明确把“给 AI 消费”作为写作目标：要求语言精确无歧义、避免俚语与依赖上下文的指代、所有缩写必须定义、文档自包含不依赖外部上下文——这些要求直接服务于“规格驱动开发”（spec-driven development）流程中，让 AI 能准确理解并据此实现功能。该技能本身是纯提示词模板，不含任何可执行脚本。
3. 适用场景
固定分类：工程效率与代码质量
适合在开发新功能、新模块或基础设施改动前，需要把口头/零散讨论固化成一份正式、可追溯规格文档的开发者与小团队——无论是准备把需求交给 AI 编码代理实现，还是单纯希望团队对需求、接口与验收标准有统一书面依据，都可以用它产出起点文档。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持，SKILL.md 遵循标准 Agent Skills 规范，可直接放入 skills 目录识别。
- Codex：⚠️ 需适配——Codex 不会自动扫描
~/.codex/skills子目录，需要在配置中显式声明技能路径后才能触发。 - OpenClaw：❓ 未验证，暂无法核实其技能发现机制是否兼容该目录结构。
- Hermes Agent：✅ 原生支持，Hermes 按路径扫描子目录探测 SKILL.md，可直接识别。
5. 推荐理由
它填补了“讨论清楚了但没人写下来”这个常见缺口：给出一套现成、结构完整的规格模板，逐节引导把需求、约束、接口契约、验收标准写成 AI 与人都能直接读懂的文档，省去团队自行设计模板的成本。技能本体是零依赖、零执行风险的纯提示词，复制即用；对应的原型 prompt 文件自 2025 年中起经过多位独立贡献者持续打磨，不是一次性提交后无人问津的内容。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 第三方目录 skills.sh 实测该技能单独安装量 13,500 次，是“规格文档生成”这一类技能中最高的一个，第二名（prd-creator）仅 4,300 次、第三名不足 2,000 次（结构化数据核验，非搜索摘要臆测） |
| 可用性 | 9 | 纯提示词模板，复制即用，无需任何配置或付费依赖；最近一次针对性修订在 2026-08-07，且对应的原型文件自 2025-07 起持续有独立贡献者提交修订，维护记录长且活跃 |
| 安全性 | 9 | 纯提示词/模板类技能，不含任何可执行脚本，不触发外部网络调用，不索取任何凭据；License 清晰 |
综合评分：8.7（三项均值）
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| to-spec（mattpocock/skills） | 把已讨论清楚的对话综合成用户故事型规格，并直接发布到项目工单追踪器 | 面向“对话转工单”的团队协作流程，产出格式是用户故事+实现/测试决策；本技能产出的是保存在仓库内 /spec/ 目录的独立 Markdown 文件，用固定编号（REQ-/CON-/GUD-/AC- 等）逐条列需求，不依赖工单系统 |
| spec-driven-development（addyosmani/agent-skills） | 面向规格驱动开发的整体方法论指导 | 讲的是“怎么做规格驱动开发”这套流程本身，本技能是流程中“落笔写一份具体规格文件”这一步的可直接套用模板，两者互补而非替代 |
| prd-creator（pageai-pro/ralph-loop） | 产出产品需求文档（PRD），面向产品经理视角 | 侧重业务/产品叙事，本技能面向工程实现视角，模板里包含接口契约、测试自动化策略等偏技术的板块 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；可查证的是其对应原型 prompt 文件自 2025-07-07 起由多位独立贡献者（含 John Haugabook、Derek Clair、CypherHK 等）陆续提交格式修复与工具名更新，2026-08-07 由贡献者 Stephen Benjamin 提交最近一次修订。
9. 安装使用方式
- 命令行：
npx skills add https://github.com/github/awesome-copilot --skill create-specification - 手动安装：从仓库
skills/create-specification/目录复制SKILL.md到目标 agent 的 skills 目录 - 安装后无需重启；触发方式为提出“为 XX 创建规格文档”一类自然语言请求，技能会引导按模板产出并保存到
/spec/目录下的对应文件
10. 注意事项
- 该技能只产出规格文档本身，不负责后续按规格实现代码，也不校验规格是否被正确落地，需要用户或另一个技能承接下一步
- 模板板块较多（十一节），对于非常小的改动可能显得偏重，可按需裁剪非必要板块
- 作为合集仓库内的独立条目，其自身在 GitHub 层面没有单独的 star/watch 计数，热度评估以第三方安装统计为准