Spec Coding Skills 套件
概述
本套件基于《一文读懂 Skills｜从概念到实操的完整指南》文章中的 Spec Coding 实践，将"需求分析 → 技术设计 → 任务拆解 → 编码实现"的完整开发流程封装为一组可协作的 Skills。
每个 Skill 遵循单一职责原则，专注于开发流程中的一个特定阶段，通过协调器 Skill 实现全流程的自动化调度。
目录结构
spec-coding-skills/
├── README.md # 本说明文件
├── requirement-analyst/ # 需求分析师技能
│ └── SKILL.md
├── system-architect/ # 技术架构师技能
│ └── SKILL.md
├── task-planner/ # 任务规划师技能
│ └── SKILL.md
├── spec-coder/ # 规范执行者技能
│ └── SKILL.md
└── spec-coordinator/ # 流程协调器技能
└── SKILL.md
技能说明
1. 需求分析师（requirement-analyst）
- 职责：将模糊的用户需求转化为清晰的需求文档
- 输入：用户的原始需求描述（可以是一句话）
- 输出：REQUIREMENT.md
- 核心能力：需求澄清、边界定义、场景细化
2. 技术架构师（system-architect）
- 职责：将需求文档转化为可实施的技术方案
- 输入：REQUIREMENT.md
- 输出：DESIGN.md
- 核心能力：技术选型、数据建模、模块设计
3. 任务规划师（task-planner）
- 职责：将技术方案拆解为可执行的开发任务
- 输入：REQUIREMENT.md + DESIGN.md
- 输出：TODO.md
- 核心能力：任务拆解、依赖分析、优先级排序
4. 规范执行者（spec-coder）
- 职责：严格按照设计文档执行编码任务
- 输入：DESIGN.md + TODO.md
- 输出：可运行的代码
- 核心能力：规范编码、自我验证、变更管理
5. 流程协调器（spec-coordinator）
- 职责：统筹调度上述四个角色技能，管理全流程
- 输入：用户的完整开发需求
- 输出：从需求到代码的完整交付
- 核心能力：流程管理、阶段协调、质量把控
使用方式
方式一：全流程执行（推荐）
直接使用 spec-coordinator 技能，它会自动按照流程调度其他技能：
“我想做一个待办事项应用，请使用 Spec Coding 流程帮我完成。”
协调器会依次推进：需求分析 → 技术设计 → 任务拆解 → 编码实现，每个阶段都会暂停等待你的确认。
方式二：单独使用某个技能
如果只需要执行特定阶段，可以直接调用对应的技能：
“帮我分析一下这个需求：[需求描述]” → 触发 requirement-analyst
“基于 REQUIREMENT.md 进行技术设计” → 触发 system-architect
“帮我拆解开发任务” → 触发 task-planner
“执行 TODO.md 中的 T-005” → 触发 spec-coder
安装方法
TRAE
- 将
spec-coding-skills/目录复制到项目的.trae/skills/目录下 - 重启或刷新 Agent，技能将自动加载
- 在设置面板的「规则技能」中确认技能已导入
Claude Desktop
- 将
spec-coding-skills/目录放置在 Claude Desktop 的 skills 目录中 - 重启 Claude Desktop
通用方式
将各个技能文件夹导入到你的 Agent 工具所支持的 skills 目录中即可。
设计原则
本套件遵循以下 Skills 最佳实践：
- 单一职责：每个 Skill 只负责一个明确的任务
- 描述清晰：使用自然语言明确说明触发条件、输入输出
- 结构化指令：包含角色设定、工作流程、输出模板、约束红线
- 可组合性：各技能可独立使用，也可通过协调器组合为完整流程
- 渐进式加载：协调器按需调用各技能，避免一次性加载过多上下文
参考来源
- 原文：《一文读懂 Skills｜从概念到实操的完整指南》
- Claude 官方 Skills 仓库：GitHub - anthropics/skills: Public repository for Agent Skills · GitHub
- Claude Skills 最佳实践：App unavailable in region | Claude
根据