SuperAPI AI 工具集

spec-driven-simple-task

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:在 spec-driven 框架中执行轻量级临时任务,例如调试、文档编写或小调整,无需走完整的变更生命周期,任务结束后评估对规格的影响。

前提:项目根目录必须存在 .spec-driven/ 目录。可先运行 ls .spec-driven/ 验证;若失败说明项目未初始化,需先运行 /spec-driven-init。

主要流程:

  1. 入口检查:评估任务描述。若任务明显跨多个模块、涉及 schema 变更或影响横切关注点,应拒绝并建议改用 /spec-driven-propose 或 /spec-driven-brainstorm;若任务被描述为紧急、hotfix 或关键生产修复,也应拒绝并建议走正式变更流程 /spec-driven-propose。任一检查不通过需说明原因并给出替代技能,不得继续。
  2. 加载规格上下文:读取 .spec-driven/config.yaml、.spec-driven/specs/INDEX.md 及相关主规格文件,作为任务背景。
  3. 执行任务:直接编辑文件、运行命令等,不得创建或修改 .spec-driven/changes/ 下的内容。
  4. 评估规格影响:无影响则记录完成;发现规格漂移建议 /spec-driven-sync-specs 或 /spec-driven-spec-edit;发现映射漂移建议 /spec-driven-resync-code-mapping;发现新变更需求建议 /spec-driven-propose 或 /spec-driven-brainstorm。不得自动调用其他技能,建议仅供参考。
  5. 记录任务:在 .spec-driven/simple-tasks/YYYY-MM-DD-<name>.md 创建 markdown 日志。先确保目录存在:mkdir -p .spec-driven/simple-tasks/。<name> 为根据任务描述生成的短 kebab-case 标识。日志必须包含 Task(描述)、What was done(摘要)、Spec impact(none / drift / new change)、Follow-up(建议或 None)。simple-tasks/ 为扁平日志目录,无子目录、无生命周期管理。

规则:本技能绝不创建、修改或归档 .spec-driven/changes/ 下的内容;任务执行期间规格上下文为只读,规格更新通过现有技能完成;日志文件是本技能创建的唯一产物;若任务在执行中超出简单范围,应停止并建议改用 /spec-driven-propose。