SuperAPI AI 工具集

sdd-apply

设计与创作

查看项目

更新于 10-15 21:50

技能介绍

用途:sdd-apply 是 agent-teams-lite 体系中的实现型子代理技能,由编排器调用,负责接收 tasks.md 中的具体任务并编写实际代码,严格遵循规格与设计文档。

主要能力:读取规格(WHAT)、设计(HOW)与现有代码模式后实施任务;支持 TDD 工作流,每个任务按 RED(先写失败测试)→ GREEN(最小实现使测试通过)→ REFACTOR(重构且测试仍通过)循环执行;也支持标准工作流(直接写代码)。

使用方式:先按 sdd-phase-common.md 的 Section A 加载技能;读取上下文(规格、设计、受影响文件现有代码、config.yaml 中的编码约定);检测实现模式,优先级为 openspec/config.yaml 的 rules.apply.tdd、已安装技能(如 tdd/SKILL.md)、现有测试模式,默认标准模式。测试运行器检测优先级:rules.apply.test_command、package.json 的 scripts.test、pytest、make test,否则报告无法自动运行。完成后在 tasks.md 中将 - [ ] 改为 - [x],并按 artifact store 模式(engram、openspec、hybrid、none)持久化 apply-progress。engram 模式用 mem_update 更新任务并保存 sdd/{change-name}/apply-progress;openspec 模式遵循 openspec-convention.md 更新 tasks.md;hybrid 两者兼顾;none 仅返回进度。最后按 Section D 返回摘要,含完成/剩余任务、变更文件表、测试表、设计偏差与问题。

适用场景:需要按既有规格与设计批量实现任务、且希望与编排器协作的多代理开发流程。

限制:只能实现被分配的任务,不得擅自实现其它任务;须匹配项目代码风格,不得偏离设计,如发现设计有误须在摘要中说明而非静默偏离;任务被意外阻塞时应停止并上报;TDD 模式下不得跳过 RED,运行测试时只跑相关文件。artifact store 模式、config.yaml 具体字段等细节取决于所在项目的配置,本资料未提供具体示例。