SuperAPI AI 工具集

plan-feature-scaffold

设计与创作

查看项目

更新于 10-15 21:56

技能介绍

用途:把已设计好产品半部分(goal、context、scope、capability closure)的功能,补全 SPEC 的工程半部分,并生成可逐阶段执行的规划产物集。仅产出文档,绝不修改代码、迁移或依赖。由 plan-feature 路由在 design-feature 或 plan-feature-from-issue 完成产品设计后调用,也可直接用于已设计的 scoped slug/SPEC;之后交由 execute-phase 执行 P1,audit-docs 可随时审计。不负责产品定义、不写代码、不决定是否构建。

主要能力:按项目 Workflow 约定与 documentation map 执行 Step 0 发现项目——读 SPEC 模板、路线图(编号/顺序/依赖)、1–2 个近期功能目录以对齐产物集合,以及架构/领域文档;缺模板/路线图时回退 agent guide 并声明假设。随后执行 scaffold 流程:把住产品半部分门禁、按需缩放产物、更新路线图状态、重读确认,并输出固定完成报告。工程计划完成后、登记 planned 前消费验证契约(ACCEPTANCE.md 的 schema、校验阶梯、防弱化规则)。阶段契约负责 8 格 phase-lint 与规范化阶段指纹。

研究:规划阶段仅在仓库证据无法回答有界问题(ROWS.md Q1–Q5)时做一次网络检索,冻结 URL 与访问日期作为证据行。必做引用追踪:用符号/引用搜索定位受影响代码(有 LSP/serena 用其,否则 grep),据此推导影响范围,不凭记忆。

护栏:尊重架构分层与 docs map 中的 domain/i18n/SEO/a11y 规则。架构不变量由规划 preflight 统一读取并做一次分类;每规则记录 ID、仓库证据及 preserves/violates/introduces/changes,仅 preserves 可生成阶段,其余须经项目声明的权威机制显式决策。写前需暴露编号冲突、依赖环、范围重叠。

完成标志:docs/features/<NN>-<slug>/ 含工程半部分、ACCEPTANCE.md 及缩放后的全部规划产物,产品半部分保持原样;路线图以正确编号、顺序、依赖和 planned 状态记录并重读确认;无代码改动,开放问题记入 decisions.md。缺失事实:具体模板、资源路径、URL 与命令细节暂未提供。