SuperAPI AI 工具集

tlc-spec-driven

编程与开发

查看项目

更新于 10-16 09:44

技能介绍

该技能提供规格驱动开发流程,用于规划并实现功能。四个阶段为 Specify、Design、Tasks、Execute;其中 Specify 和 Execute 必选,Design 与 Tasks 在范围不需要时由代理自动跳过。复杂度决定深度:小型改动只写一行规格并内联实现验证;中型写简要规格;大型使用完整规格、需求 ID、架构、组件与任务依赖;复杂场景在规格阶段讨论灰色地带,并在执行阶段做交互式 UAT,必要时先研究架构。

核心规则:测试从规格验收标准派生并断言规格定义的结果,不得镜像实现;任务完成前必须通过测试门禁;每个任务一次原子提交,并在提交前更新 tasks.md;最后一个任务后自动运行独立验证器,作者与验证者不得相同。批准规格或任务只授权本地实现与本地提交,推送、部署、生产数据库变更等需另行明确许可。

确定性门禁由脚本执行,如 python3 <skill-dir>/scripts/validate_spec.py、validate_tasks.py、check_commit.py、validate_state.py,非零退出即停止修正。

工程产物放在 .specs/ 下,按需惰性创建:STATE.md 记录决策与交接快照,LESSONS.md 由脚本渲染,features/[feature]/ 下可有 spec.md、context.md、design.md、tasks.md、validation.md。恢复工作时读取 STATE.md 并与 git 和 tasks.md 核对,以证据为准。

子代理委派:任务打包超过约 8 个时先征得用户同意再派发,每批约 7 个任务,按阶段顺序整批执行,串行推进;验证器在最后任务提交后自动派发,执行规格锚定结果检查与区分度传感器,并输出 validation.md。若运行环境不支持子代理,则在最终提交后独立走一遍验证流程。

研究技术决策遵循固定链条:先查代码库、项目文档、Context7 MCP、网络搜索,仍无法确定则明确标注不确定,不得编造 API 或行为。输出上直接产出对应阶段的产物,不叙述流程。若工具支持按子代理选择模型,可依子代理文档中的分级建议分配;不支持则忽略。验证循环失败时最多迭代三次后升级。缺失事实暂未提供。