SuperAPI AI 工具集

sdd-onboard

办公与效率

查看项目

更新于 10-15 21:50

技能介绍

用途:用用户真实的代码库完整演示一遍 SDD(规范驱动开发)流程,从探索到归档,做一次真实的小改动,通过实践教学。

主要能力:扫描代码库找出一个小范围、低风险、有真实价值的改进点(如缺失输入校验、错误信息不一致、可抽取复用的工具函数、异步组件缺失加载/错误状态、含明确意图的 TODO/FIXME),给出 2-3 个选项供用户选择;随后按阶段逐步引导:探索(explore)、提案(propose)、规范(spec)、设计(design)、任务(tasks)、实现(apply)、验证(verify)、归档(archive),每阶段配简短讲解,并生成 proposal.md、specs/{capability}/spec.md、design.md、tasks.md 等产物。

使用方式:由编排器内联执行,属于交互式演练,不做子代理委派。接收产物存储模式(engram | openspec | hybrid | none)和可选的重点改进方向。若处于严格 TDD 模式,实现阶段遵循 RED → GREEN → TRIANGULATE → REFACTOR 循环。

适用场景:想学习或向团队演示 SDD 流程时;适合作需要先对齐“做什么”再写代码的改动,如功能、API、架构决策。小调整直接编码即可。

限制:这是真实改动而非玩具示例,产物和代码需达到生产质量;每阶段讲解保持简短(1-3 句);提案阶段后须先经用户确认再继续;若用户自选改进点,需先验证符合“小而安全”标准;遇到阻塞(测试失败、设计不清、代码库过复杂)应停下说明而非硬推;技术产物默认英文,除非用户明确要求其他语言。