SuperAPI AI 工具集

spec-code

编程与开发

查看项目

更新于 10-15 16:51

技能介绍

spec-code 用于从规范文档中自主实现单个任务,写代码前先理解完整项目上下文。

用途:按 tasks.md 中的任务 ID 实现一项任务,或在反馈模式下修复评审/测试发现的问题。

主要能力与用法:

  • 选项:--issue {N} 提供 GitHub Issue 上下文;--spec {path} 指定 .specs/ 目录;--task {task-id} 指定要实现的任务(如 T-007);--feedback {file} 进入反馈模式,读取评审或测试结果文件并处理发现项。
  • 执行流程:首次调用加载完整上下文(读取工作流、Issue、requirement.md/design.md/tasks.md、项目规则),反馈重调用只加载反馈文件、目标任务、相关设计段与上次改动文件。随后定位目标任务、参考设计、实现、核对完成标准并提交。
  • 实现时只创建或修改任务指定的文件,遵循 coding-rules.md 与项目约定。提交默认格式为 feat(scope): {task-id} — {brief description},仅暂存实现文件,不修改 tasks.md,不更新其复选框。
  • 反馈模式按文件头 type 处理:review 只修复标记 fix_before: implementation 的发现项(先 Critical 后 Improvement);test 修复失败用例与未覆盖的完成标准;evaluate 同 review 处理,忽略 ## Blocked 部分。
  • 语言规则:自动检测输入语言并同语言输出,日文用 references/code-guide.ja.md,英文用 references/code-guide.md,显式覆盖优先。

使用示例: /spec-code --issue 36 --task T-007 --spec .specs/did-deactivation/ /spec-code --task T-007 --spec .specs/did-deactivation/ --feedback .specs/did-deactivation/review-T-007.md

限制:任务是已在 tasks.md 中勾选 [x] 时会警告并停止;找不到 --spec 路径、任务 ID 或反馈文件时分别报错;找不到设计段落或编码规则时给出警告并按任务描述与项目默认继续。其他收费、平台与效果资料暂未提供。