pianzhu 方案设计 - 详细规则
目标: 构思可行方案并制定详细执行计划，生成 plan/ 目录下的方案包
前置条件: 需求分析已完成（评分≥7分）
重要: 方案设计必须创建新方案包，适用于所有模式（交互确认/全授权/规划命令）
执行流程:
方案构思 → [用户确认/推进模式下连续] → 详细规划（创建新方案包）
方案构思
动作步骤
1. 检查知识库状态并处理
- 按 G10 快速决策树判定
- 如需创建/重建知识库 → 读取
../kb/SKILL.md执行完整流程
2. 读取知识库
- 按 G10 快速流程执行（先检查知识库 → 不足则扫描代码库）
- 如需详细规则 → 读取
../kb/SKILL.md
3. 判定项目规模
- 按 G4 规则执行
4. 判定需求类型并选择模板
- 按G8判定是否触发产品设计原则
- 技术变更（未触发G8）: 使用基础模板
- 产品功能（触发G8）: 使用完整模板（包含产品分析章节）
5. 产品视角分析（步骤4判定为"产品功能"时执行）
- 用户画像、场景分析、痛点分析
- 价值主张、成功指标
- 人文关怀考量
6. 任务复杂度判定
满足任一条件为复杂任务:
- 需求属于"新项目初始化"或"重大功能重构"
- 涉及架构决策
- 涉及技术选型
- 存在多种实现路径
- 涉及多个模块(>1)或影响文件数>3
- 用户明确要求多方案
7. 方案构思
方案构思推理过程（在 标签中完成，不输出给用户）：
<thinking>
1. 列举所有可能的技术路径
2. 逐一评估每个路径的优缺点、风险、成本
3. 筛选出 2-3 个最可行的方案
4. 确定推荐方案及理由
</thinking>
基于推理结果执行：
复杂任务（强制方案对比）:
- 生成 2-3 个可行方案
- 详细评估每个方案
- 确定推荐方案和理由
- 输出格式: 推荐方案标题后加"推荐"标识
- 例: "方案1（最小变更修复-推荐）" vs "方案2（完整重构）"
- 交互确认模式: 输出方案对比，询问用户选择
- 推进模式: 选择推荐方案（不输出对比）
简单任务:
- 直接确定唯一可行方案
- 简要说明方案
方案构思 输出格式（等待用户选择方案时）
行首: ❓【HelloAGENTS】- 方案构思
输出内容(≤5条要点):
❓【HelloAGENTS】- 方案构思
- 📚 上下文: [项目规模] | [知识库状态]
- 📋 需求类型: [技术变更/产品功能]
- 🔍 复杂度: [复杂任务] - [判定依据]
- 💡 方案对比:
- 方案1: [名称-推荐] - [一句话说明]
- 方案2: [名称] - [一句话说明]
- ⚠️ 风险提示: [如有EHRB或重大风险]
────
🔄 下一步: 请输入方案序号(1/2/3)选择方案
详细方案说明: 如用户需要详细对比，可追问后展开
方案构思 子阶段转换
复杂任务:
交互确认模式:
- 用户选择有效序号(1-N) → 进入详细规划
- 用户拒绝所有方案 → 输出重新构思询问格式
- 确认重新构思: 返回方案构思，重新构思
- 拒绝: 提示"已取消方案设计"，流程终止
- 其他输入: 再次询问
推进模式:
- 选择推荐方案 → 立即静默进入详细规划
简单任务: 直接进入详细规划
重新构思方案询问格式:
❓【HelloAGENTS】- 方案确认
所有方案均被拒绝。
[1] 重新构思 - 基于反馈重新设计方案
[2] 取消 - 终止方案设计
────
🔄 下一步: 请输入序号选择
详细规划
前提: 用户已选择/确认方案（来自方案构思）
重要: 必须创建新方案包，使用当前时间戳，不得复用 plan/ 中的遗留方案
动作步骤
所有文件操作遵循G5静默执行规范
1. 创建新方案包目录
路径: plan/YYYYMMDDHHMM_<feature>/
冲突处理:
1. 检查 plan/YYYYMMDDHHMM_<feature>/ 是否存在
2. 如不存在 → 直接创建
3. 如存在 → 使用版本后缀: plan/YYYYMMDDHHMM_<feature>_v2/
(如 _v2 也存在，则递增为 _v3, _v4...)
示例:
- 首次创建: plan/202511181430_login/
- 同名冲突: plan/202511181430_login_v2/
2. 新库/框架文档查询（如需要）
触发条件: 方案涉及项目中从未使用过的第三方库/框架，或涉及重大版本升级
执行方式: 使用联网搜索或MCP工具(Context7)查询最新文档
记录位置: how.md 的 技术方案 章节
3. 生成方案文件
读取 ../templates/SKILL.md 获取模板，生成:
why.md(变更提案/产品提案)how.md(技术设计+ADR)task.md(任务清单)
任务清单编写规则:
单任务代码改动量控制:
- 常规项目: ≤3文件/任务
- 大型项目: ≤2文件/任务
验证任务: 定期插入
安全检查: 必须包含安全检查任务
4. 风险规避措施制定
- 基于方案构思风险评估，按G9制定详细规避措施
- 交互确认模式: 询问用户
- MODE_FULL_AUTH=true 或 MODE_PLANNING=true: 规避风险
- 写入
how.md的 安全与性能 章节
5. 设置方案包跟踪变量
设置: CREATED_PACKAGE = 步骤1创建的方案包路径
用途: 在全授权命令中传递给开发实施，确保执行正确的方案包
方案设计 输出格式
⚠️ CRITICAL - 强制要求:
- ALWAYS使用G6.1统一输出格式
- NEVER使用自由文本替代规范格式
- 输出前MUST验证格式完整性
严格调用 G6.1 统一输出格式，填充以下数据：
- 阶段名称:
方案设计 - 阶段具体内容(≤5条要点):
- 📚 知识库状态
- 📝 方案概要（复杂度、方案说明）
- 📋 变更清单
- 📊 任务清单概要
- ⚠️ 风险评估（如检测到EHRB）
- 文件变更清单:
helloagents/plan/YYYYMMDDHHMM_<feature>/why.mdhelloagents/plan/YYYYMMDDHHMM_<feature>/how.mdhelloagents/plan/YYYYMMDDHHMM_<feature>/task.md
- 下一步建议:
- 交互确认模式: 是否进入开发实施?（是/否）
- 规划命令: 方案包已生成，如需执行请输入
~exec
- 遗留方案提醒:
- 按G11扫描plan/目录
- 如检测到遗留方案包（排除本次创建的方案包），按G11规则显示
阶段转换规则
交互确认模式:
- 输出总结（包含"🔄 下一步: 是否进入开发实施?(是/否)"）
- 停止并等待用户明确确认
- 用户响应处理：
- 明确确认("是"/"继续"/"确认"等) → 进入开发实施
- 明确拒绝("否"/"取消"等) → 流程终止
- Feedback-Delta(提出修改意见) → 按Feedback-Delta规则处理
- 其他输入 → 视为新的用户需求，按路由机制重新判定
推进模式:
- 全授权命令: 完成方案设计 → 立即静默进入开发实施
- 规划命令: 输出整体总结 → 停止 → 清除MODE_PLANNING
关键约束（只有以下3种情况可以进入开发实施）：
1. 方案设计完成后用户明确确认
2. 全授权命令(~auto等)触发且已完成方案设计
3. 执行命令(~exec等)触发且plan/中存在方案包