用途:把阶段1的需求(PM 需求 + UI 示意)转化为阶段2的标准化产物,即 docs/plans/{Story-Key}/plan.md,供后续执行阶段使用。
主要能力:读取 Jira Story 描述、AC、附件链接,读取并优先继承 docs/plans/{Story-Key}/analysis.md,结合 docs/specs/PRD.md、docs/specs/SAD.md、docs/modules/*.md 与当前代码、测试、配置,产出可执行、可验证、可交接的计划。
产出契约:计划文件必须落在 docs/plans/{Story-Key}/;首次文件名为 plan.md,已存在则使用 plan-1.md、plan-2.md 等,禁止覆盖已有计划。内容需包含状态管理(整体进度、任务状态总览、执行记录)、需求理解与范围边界、UI/交互约束、任务拆解(每任务2-5分钟)、测试用例与验收标准、AI 执行指引与人工 Gate、档案系统回补任务。每个任务以 TDD 方式描述:RED → 验证失败 → GREEN → 验证通过 → REFACTOR → 再次验证。
上下文优先级:analysis.md 第一;Story 描述第二;规格与模块文档第三;代码、测试与配置第四。
降级规则:无 analysis.md 时不得停止,需以降级模式继续生成,并显式标注降级生成说明、上下文来源、关键假设、待确认问题与代码现状观察。analysis.md 不完整时可补齐并标注来源。若 Story 与 analysis.md 重大冲突,须先标记冲突并请用户确认,未确认前不得生成 plan.md。
边界:本技能不负责创建 Jira Sub-task,不默认执行 Jira 写操作;仅当用户明确要求时才执行 git commit,且只提交当前 Story 相关文件。
使用方式:开始时声明“我正在使用 aile-writing-plans 技能来生成团队计划。”按 Step 0 读取上下文、Step 0.1 校验分析文件、Step 1 确认 Story-Key 与范围、Step 2 任务拆解排序、Step 3 写入计划文件、Step 4 提交 Git(需用户明确要求)、Step 5 交接到 aile-executing-plans 或 aile-subagent-dev。
适用场景:已获得 Jira Story 需求描述、已有 analysis.md 或仅有 Story/代码上下文、需要产出可执行计划时。限制:缺少 Story/需求输入且无法从代码与文档识别变更目标时方可停止;具体安装方式、平台与收费信息暂未提供。