increment-planner

Increment Planner Skill 是 SpecWeave 体系中的一个技能，用于在 specweave init 之后，为任意用户项目提供自包含的增量规划能力。它面向启动新功能、热修复、缺陷修复或任何开发工作的场景，通过 PM 与 Architect 智能体协作完成规划。

【用途】 该技能用于规划并创建 SpecWeave increment。当用户开始新功能、hotfix、bug 或其他开发工作时使用。它支持在任意用户项目中使用，前提是已执行 specweave init。

【主要能力】

1. 渐进式披露（Progressive Disclosure）：按需加载阶段文件以减少上下文占用。阶段包括：Pre-flight（开始规划时加载 phases/00-preflight.md）、Project Context（解析项目/看板时加载 phases/01-project-context.md）、Create Increment（创建文件时加载 phases/02-create-increment.md）、Reference（示例与故障排查，加载 phases/03-reference.md）。
2. 增量类型管理：feature（新功能，WIP 上限 2）、hotfix（生产故障，无限制）、bug（需要 RCA，无限制）、change-request（业务变更，上限 2）、refactor（技术债，上限 1）、experiment（POC/spike，无限制）。
3. 目录结构规范：.specweave/increments/####-name/ 下包含 metadata.json（必需，最先创建）、spec.md（必需，用户故事与验收标准）、plan.md（可选，架构）、tasks.md（必需，实现）。
4. 工作流：STEP 0 预检（TDD 模式、多项目、深度访谈）；STEP 0.5 深度访谈（若启用，由 PM 技能加载 phases/00-deep-interview.md，提出 10-40+ 个关于架构、集成等的问题，直到覆盖所有类别）；STEP 1 项目上下文（解析项目/看板）；STEP 2 通过模板 API 创建增量；STEP 3 在主对话中引导用户完成。
5. 深度访谈模式检测：在预检时通过 jq 读取 .specweave/config.json 中的 planning.deepInterview.enabled，若为 true 则进入深度访谈模式，类别包括 architecture、integrations、ui-ux、performance、security、edge-cases；至少提问 10 个（大型功能 40+），覆盖所有配置类别，访谈完成后才进入 STEP 1。

【使用方式】 可直接调用：Skill({ skill: "sw:increment-planner", args: "--description="Add auth"" })；推荐通过命令调用（会处理预检）：/sw:increment "Add user authentication"。注意必须使用 sw: 前缀，直接写 increment-planner 会失败。

【关键规则】

1. Project 字段为必填：每个用户故事（US）必须有 Project: 字段，可通过 specweave context projects 获取项目。
2. 必须使用模板创建 API：禁止直接写入，应使用 specweave create-increment --id "0021-name" --project "my-app"。
3. 禁止生成智能体：技能不得生成 Task() 智能体（会导致崩溃），应引导用户在主对话中完成。
4. 增量命名格式：####-descriptive-kebab-case，例如 0001-user-authentication；不可只有编号或只有描述。

【Token 预算】 本快速参考文件约 400 tokens；每个阶段约 300-500 tokens；全部加载约 2000 tokens。应按需加载阶段，而非一次性全部加载。

【委托】 预检检查由 /sw:increment 命令处理 WIP 与纪律；规格完成由 PM 技能在主对话中处理；架构由 Architect 技能在主对话中处理；任务生成由测试感知规划器在主对话中处理。

【适用场景】 适用于已执行 specweave init 的任意用户项目，在启动新功能、热修复、缺陷修复、业务变更、重构或实验性 POC/spike 时进行增量规划。

【限制】 技能不得生成 Task() 智能体；必须使用模板创建 API 而非直接写入；Project 字段必填；命名必须符合 ####-descriptive-kebab-case 格式；调用时必须使用 sw: 前缀。关于收费、价格、平台支持等具体信息，资料中暂未提供。