Imported from shflx/ysir (skills/ysir-plan/SKILL.md). Install upstream with npx skills add shflx/ysir --skill ysir-plan. Copyright stays with the author.

ysir-plan

目标

根据需求文档和仓库上下文，产出后续 Coding Agent 可直接执行、验证和分迭代交付的实现方案文档。

核心原则

1. 只规划当前需求的实现，不扩张范围；空项目先确定技术栈和标准目录结构。
2. 基于现有设计、代码、测试、脚本和项目约定形成方案；偏离既有约定时必须说明理由和代价。
3. 不重新访谈需求；仅当缺失信息或设计冲突会阻塞方案正确性时，才向用户确认。
4. 此阶段只允许编辑方案文档，不允许编写实现代码或测试代码。
5. 分迭代计划必须按业务需求拆分：优先使用需求能力、用户可见成果、业务流程步骤或可独立落地的业务切片作为迭代边界；不得按开发、测试、验收、代码审查、提交、归档等工程阶段或流程动作拆分。

工作流程

开展实现规划前，先使用技能 ysir-regulation 学习项目规范。

1. 读取输入

• 阅读当前需求目录下的 order.md。
• 阅读 .report/design 中与本需求相关的设计文档。
• 阅读仓库中影响方案判断的入口、模块、测试和脚本。

2. 输出方案

• 方案文档格式必须符合 references/plan.md

• 默认输出路径: .report/in-progress/{日期}-{需求简短描述}/plan.md

• 分迭代的实现计划 必须体现业务拆分结果，而不是工程执行阶段。每个迭代标题应是业务能力或业务切片名称，不能是“开发”“测试”“验收”“代码审查”“提交”“归档”等流程阶段。

• 预计改动 和迭代 改动 只允许包含为满足业务需求而修改或交付的工程产物与可验证成果；测试报告、代码审查报告、提交记录、归档文档等流程产物只能由对应执行阶段按规范产出。

3. 初始化状态图

• 使用 ysir-configure 读取 developmentMethod 和人工验收配置；developmentMethod 未配置时按 standard 处理，若不是 standard 或 tdd 则暂停向用户确认。

• 状态图节点来自 分迭代的实现计划 的业务阶段；软件方法只作为 ysir-state 的 --schema {developmentMethod} 展开执行子阶段，不产生其它副作用。

• 使用 ysir-state 初始化 .report/in-progress/{日期}-{需求简短描述}/state.json；生成或执行初始化命令时必须补齐完整参数，人工验收开启时追加 --human-acceptance true。