SuperAPI AI 工具集

specs-kit-task-implementation

编程与开发

查看项目

更新于 10-27 10:54

技能介绍

用途:该技能面向开发者,用于从 /skill:specs-kit-spec-to-tasks 生成的任务清单中执行某个具体任务,按单一任务的聚焦流程推进实现。

主要能力:支持通过 --task 指定任务文件路径(必填),--spec 指定规范目录(可选,缺省时从任务路径推导);任务路径可写成完整路径或仅任务编号(如 TASK-003),后者自动从分支识别规范。--action 缺省时走完整流程(T-1 至 T-6,T-7 可选),取 cleanup 时直接跳到 T-7 代码清理,但仍先执行 T-7.1 校验审阅状态。流程包括:T-1 任务识别(读取 YAML frontmatter 中的任务 ID、标题、描述、验收标准、DoR/DoD、依赖、规范引用、imp-requirements 与 ac-mapping,并做规范可追溯性检查);T-2 Git 状态检查(用 git status --porcelain 检查未提交更改,并检测 package.json、Makefile、pom.xml、build.gradle、pyproject.toml、composer.json 等配置中的 lint 与测试命令);T-3 依赖检查;T-3.5 基于 graphify-out/graph.json 的代码库图谱校验;T-3.6 契约校验(区分前三个任务可提议接口、后续任务须遵守 provides 约定,破坏需在 decision-log.md 记录 DEC);T-3.7 检查此前的审阅报告与必需修复项;T-4 实施;T-5 验证(构建、仅相关模块测试、新增测试、核对验收标准与 DoD);T-6 完成任务(勾选验收标准与 DoD、置 status: implemented、填 implemented_date 与 provides、写变更摘要并运行同步命令);T-7 审阅后清理(验证审阅状态、定位文件、用 Grep 清除调试残留与已解决 TODO、按项目配置优化导入与格式)。

使用方式:命令为 /skill:specs-kit-task-implementation --task=task-name,示例:/skill:specs-kit-task-implementation --task=docs/specs/001-feature/tasks/TASK-001.md 或 /skill:specs-kit-task-implementation --task=TASK-003。完成后提示运行 /skill:specs-kit-task-review --task=TASK-XXX 进行审阅,并运行 /skill:specs-kit-sync 更新技术上下文、检测规范与代码偏差。

适用场景:已有规范与任务清单、需要逐个落实开发任务并保持规范追溯与契约一致性的项目;也可用于审阅通过后的代码清理。

限制:仅在任务模式下工作,未提供 --task 参数时须先用规范驱动流程生成任务;规范的需求文档及其 contracts/ 目录为只读,不能在此改写,若需求不可能、矛盾或契约不可行,应在实现摘要中说明而不修改文档;不提供时间估算;遇到歧义或阻塞时通过 ask_user_question 询问;缺少代码库图谱时跳过该校验并提示运行 /graphify。