用途:本技能处于项目工作流的阶段2,把 Jira Story 的输入(需求描述、验收条件、UI 示意、约束)转成可用于计划与设计的结构化材料。它只做分析、澄清与结构化输出,产出或更新 docs/plans/{Story-Key}/analysis.md。
主要能力:理解想法并检查项目状态(文档与最近提交);一次只问一个问题,优先多选题,聚焦目的、约束与成功标准;提出 2-3 种权衡方法并给出推荐与理由;分 200-300 字小节展示设计并逐段确认,涵盖架构、组件、数据流、错误处理与测试;将验收条件改写成可测试条目,列隐含需求(权限、空状态、错误状态、性能/兼容性)与风险。
产出契约:analysis.md 必须包含需求理解与风险、用户路径/核心交互、AC 初稿、隐含需求清单、档案系统回补建议、建议的阶段2下一步与子任务决策记录。文件须明确写出是否建议后续回补档案系统、建议回补的文件路径或文档域(如 docs/specs/PRD.md、docs/modules/payment.md)、原因与影响范围、建议执行的后续任务。
限制:本技能不修改业务代码、测试代码、规格文档与模块文档,也不得直接改动 docs/specs/、docs/modules/、docs/guides/* 或执行云端同步归档;子任务创建属 aile-writing-plans 职责,本阶段禁止创建 Jira Sub-task,缺失/gap/补漏/缺陷修补类单据只输出结论与建议,未获用户明确授权不得调用创建接口。Jira MCP 可选,凭据须通过环境变量注入,不得写入仓库;回填须先生成 ADF 草稿,若工具链不支持 ADF 则禁止自动回填,降级为输出 ADF 内容并提示人工提交,禁止把纯 Markdown 冒充 ADF。未确认工具支持前不得自动回填并报成功。
适用场景:团队基于 Jira Story 的需求接入与澄清阶段。官方资料未提供安装命令、收费与价格信息。