SuperAPI AI 工具集

implementation-task-planner

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:把已批准的需求与设计资料转成可执行的任务计划,供其他智能体或工程师直接开工,不负责实现代码。

主要能力:按阶段、故事或垂直切片分组的有序任务;每个任务追溯到验收标准、架构决策、风险与来源资料;在有意义处先写测试;标注依赖与可并行任务的 [P] 标记;可推断时给出预期文件目标;提供验证命令(未知时标 TBD after bootstrap);给出下游技能路由提示;区分可执行任务与待解决问题、阻塞项。

输入顺序:已批准的产品规格、PRD、issue、epic 或用户故事;验收标准、示例、业务规则与非功能需求;架构方案、API 契约、数据模型、ADR、图表或技术设计;项目规范、编码标准、仓库约定与现有任务模板;若项目已存在,还包括仓库结构与测试命令。关键资料缺失时,仅在有用时建立规划骨架,不得编造验收标准、架构决策、文件路径或命令。

就绪门:先分类为 ready、partial 或 blocked。partial 写可执行子集并列出待解决问题;blocked 只输出阻塞报告,不产出虚假任务列表。

工作流:盘点来源资料并记录标识、路径或链接;提取验收标准、架构决策、约束与验证信号;找出首个可独立演示的垂直切片;构建依赖图;在可行时让契约、脚手架与测试先于依赖实现;拆分小而可独立审查的任务;仅在任务互不依赖且不修改同一不稳定契约、模式、迁移或共享面时加 [P];附加追溯、文件目标、验证命令与技能路由;按质量清单校验;写 tasks.md,需要机器可读时再写 tasks.json。默认路径 specs/001-<feature-slug>/tasks.md 与 tasks.json,已存在文件不要覆盖无关规划文件。

任务设计规则:使用稳定 ID(T001、T002);尽量用验收标准 ID(如 [AC-001]),无则建本地标签并映射;依赖允许时优先垂直切片;任务面向动作且可验证;可测行为先写失败测试或更新测试;基础设施与引导任务和功能行为分开;迁移、API 契约、生成客户端与共享模式先于其消费者;文档与发布任务仅在来源或约定要求时加入。

输出契约:Markdown 采用“# Implementation Tasks: 特性名”、Source readiness、First vertical slice、Source Artifacts、Phase 分节(任务含 Skill、Files、Depends on、Validates、Command)、Dependencies、Parallel Groups、Validation Plan、Open Questions。JSON 需符合 references/tasks-json-schema.json,至少含 schema_version、project、readiness、source_artifacts、tasks、dependencies、parallel_groups、validation_commands、skill_routes、open_questions;每个任务需有 ID、标题、状态、阶段、追溯、依赖、并行标记、预期文件、验证命令与技能路由。

技能路由默认:Angular 组件/路由/表单/服务用 angular-developer;Java 或 Spring Boot 用 dr-jskill,测试用 junit5-skill;OpenAPI 契约或生成客户端用 openapi-spec-generation;MCP 服务器或工具集成用 mcp-builder;单元或组件测试用 stack-aware-unit-testing-skill;REST API 测试用 restassured-skill 或 api-contract-sentinel;浏览器流程测试用 playwright-skill 或 cypress-skill;响应式 UI 验证用 responsive-testing;无障碍检查用 a11y-audit-agent-skill;发布说明、版本与就绪用 release-manager-skill;无合适技能时用 native agent。

记忆模型:运行时记忆仅用于当前规划轮次;仅当仓库已有 docs/、specs/ 或项目任务模板等明确位置时,才持久化项目本地规划约定;不写跨智能体共享记忆,用户要求跨项目保留时转交外部共享记忆能力并请求明确确认;未经标注或来源确认,不得把运行时假设写入项目工件。

限制:不得从零创建产品需求、验收标准、架构决策或技术设计,应转交上游规划技能;不得把未决决策藏进任务;不得编造与架构、约定或生成布局冲突的文件;不得把依赖同一未定契约的任务标为并行;不得创建混合无关故事、层或审查关注点的巨型任务;不得声称仓库中不存在且无法合理推断的验证命令存在;不得覆盖用户撰写的规划工件;不添加自主自我改进、自我修改或记忆提升机制。需要更完整模板时加载 references/task-template.md;评估或更严格评分时加载 references/quality-rubric.md。最终回复只报告:创建或更新的任务文件、就绪分类、首个垂直切片、各阶段任务数、并行组、验证命令、阻塞性待解决问题,保持简洁。