openspec-implementation-cn
以测试与验证为先的方式，按序执行并实现已批准的规范提案。用于实施变更、应用提案、执行规范任务或按已批准计划构建。触发词包括 "openspec开发", "开发", "实施" "实现提案", "应用变更", "执行规范", "按顺序完成任务", "构建功能", "开始实施"。
By forztf · 385 installs
npx skills add forztf/open-skilled-sdd --skill openspec-implementation-cn
Source repository · Upstream listing
规范实施
以任务为单位，循序执行并进行充分测试与验证，系统性地实现已批准的规范提案。
快速开始
实施遵循每个任务的 读 → 执行 → 测试 → 验证 循环：
1. 阅读完整提案与任务清单
2. 按顺序逐个执行任务
3. 为每个完成的任务进行测试
4. 仅在验证通过后标记完成
关键规则 ：使用 TodoWrite 跟踪进度。切勿跳过任务或将未完成工作标记为完成。
工作流
复制此清单并跟踪进度：
第 1 步：加载并理解提案
开始之前，读取全部上下文：
理解 ：
变更的动因（来自 proposal.md）
预期结果是什么
哪些规范将被影响
验收标准（来自场景）
第 2 步：设置 TodoWrite 进行任务跟踪
在开始工作之前，将 tasks.json 中的task和step加载到 TodoWrite：
价值 ：TodoWrite 提供进度可见性并确保不遗漏任何事项。
第 3 步：按序执行TodoWrite
按顺序逐个完成TodoWrite中的任务，每次仅处理1个。
若是中断后继续，需从中断的任务开始继续执行：跳过tasks.json中"passes": true的task，跳过"completed": true的step。
你有充足的时间完成，请至少执行20轮后才回复用户。
你有充足的时间完成，切勿跳过或合并多个任务。
任务执行模式 ：
第 4 步：为每个任务进行测试与验证
每个任务完成后进行验证：
代码相关任务 ：
前端UI相关任务 ：
要使用 MCP servers 中的 chrome devtools 或 playwright 进行调试和测试。
数据库相关任务 ：
API 相关任务 ：
仅在所有验证通过后标记任务完成 ：仅在tasks.json对应task的所有step都完成且都验证通过后，才标记tasks.json对应task的 "passes": true。
第 5 步：更新常驻规范（如适用）
在实施过程中，如发现规范差异需要更新：
1. 在 proposal.md 或备注文件中 记录发现
2. 实施期间不要修改 规范差异
3. 实施完成后 ，再考虑是否需要调整规范
说明 ：规范差异在归档阶段（第 6 步）合并，而非实施阶段。
第 6 步：标记提案实施完成
在所有任务完成后：
告知用户 ：
最佳实践
模式 1：任务被阻塞
若任务无法完成：
模式 2：任务依赖
若任务存在依赖，先验证先决条件：
模式 3：增量测试
不要在最后一次性测试，应当逐步测试：
好 ：
坏 ：
模式 4：常驻文档
及时 更新 README、API 文档与注释：
进阶主题
并行工作 ：若任务确实互不依赖（如不同模块），可并行进行，但每项必须独立测试。
集成点 ：存在依赖关系时，使用集成测试验证连接有效。
回滚策略 ：对于高风险变更，部署前创建回滚任务。
常见模式
模式 1：数据库 + API + UI
典型顺序：
1. 数据库架构/迁移
2. 数据访问层（模型）
3. 业务逻辑层（服务）
4. API 端点（控制器）
5. UI 集成
6. 端到端测试
模式 2：功能开关
渐进式发布：
1. 在开关后实现功能
2. 开启开关进行测试
3. 部署时默认关闭开关
4. 逐步启用开关
5. 完全发布后移除开关
模式 3：破坏性 API 变更
对于 API 破坏性变更：
1. 实现新版本（v2）
2. 保持旧版本（v1）运行
3. 在 v1 中添加弃用提示
4. 迁移用户至 v2
5. 单独提案移除 v1
反模式避免
不要 ：
跳过单个任务的测试
在验证前标记任务完成
忽视失败测试（不要“以后再修”）
在测试前批量合并多个任务
在实施阶段修改常驻规范
打乱任务顺序（破坏依赖）
要 ：
立刻测试每个任务
在继续前修复失败测试
实时更新 TodoWrite
清晰记录阻塞项
及时同步进度与用户
保持原子且具描述性的提交
故障排查
问题：任务完成后测试失败
解决方案 ：
问题：任务过大
解决方案 ：
问题：依赖未满足
解决方案 ：
参考资料
[TASK PATTERNS.md](reference/TASK PATTERNS.md) 常见任务执行模式
[TESTING STRATEGIES.md](reference/TESTING STRATEGIES.md) 按任务类型的测试方法
Token 预算 ：此 SKILL.md 约 350 行，低于建议的 500 行上限。