AgentSkillsCN

design

方案设计阶段详细规则；进入方案设计时读取；包含方案构思、任务拆解、风险评估、方案包创建

SKILL.md
--- frontmatter
name: design
description: 方案设计阶段详细规则；进入方案设计时读取；包含方案构思、任务拆解、风险评估、方案包创建

方案设计 - 详细规则

目标: 构思可行方案并制定详细执行计划，生成 plan/ 目录下的方案包

前置条件: 需求分析已完成（评分≥7分）

重要: 方案设计必须创建新方案包，适用于所有模式（交互确认/全授权/规划命令）

执行流程:

code
方案构思 → [用户确认/推进模式下连续] → 详细规划（创建新方案包）

方案构思

动作步骤

1. 检查知识库状态并处理

  • •按 G10 快速决策树判定
  • •如需创建/重建知识库 → 读取 kb Skill执行完整流程

2. 读取知识库

  • •按 G10 快速流程执行（先检查知识库 → 不足则扫描代码库）
  • •如需详细规则 → 读取 kb Skill

3. 判定项目规模

  • •按 G4 规则执行

4. 判定需求类型并选择模板

  • •按G8判定是否触发产品设计原则
  • •技术变更（未触发G8）: 使用基础模板
  • •产品功能（触发G8）: 使用完整模板（包含产品分析章节）

5. 产品视角分析（步骤4判定为"产品功能"时执行）

  • •用户画像、场景分析、痛点分析
  • •价值主张、成功指标
  • •人文关怀考量

6. 任务复杂度判定

满足任一条件为复杂任务:

yaml
- 需求属于"新项目初始化"或"重大功能重构"
- 涉及架构决策
- 涉及技术选型
- 存在多种实现路径
- 涉及多个模块(>1)或影响文件数>3
- 用户明确要求多方案

7. 方案构思

<solution_design> 方案评估标准:

  • •优点
  • •缺点
  • •性能影响
  • •可维护性
  • •实现复杂度
  • •风险评估（含EHRB）
  • •成本估算
  • •是否符合最佳实践

方案构思推理过程（在 <thinking> 标签中完成，不输出给用户）：

code
<thinking>
1. 列举所有可能的技术路径
2. 逐一评估每个路径的优缺点、风险、成本
3. 筛选出 2-3 个最可行的方案
4. 确定推荐方案及理由
</thinking>

基于推理结果执行：

复杂任务（强制方案对比）:

  • •生成 2-3 个可行方案
  • •详细评估每个方案
  • •确定推荐方案和理由
  • •输出格式: 推荐方案标题后加"推荐"标识
    • •例: "方案1（最小变更修复-推荐）" vs "方案2（完整重构）"
  • •交互确认模式: 输出方案对比，询问用户选择
  • •推进模式: 选择推荐方案（不输出对比）

简单任务:

  • •直接确定唯一可行方案
  • •简要说明方案 </solution_design>

方案构思 输出格式（等待用户选择方案时）

行首: ❓【HelloAGENTS】- 方案构思

输出内容(≤5条要点):

code
❓【HelloAGENTS】- 方案构思

- 📚 上下文: [项目规模] | [知识库状态]
- 📋 需求类型: [技术变更/产品功能]
- 🔍 复杂度: [复杂任务] - [判定依据]
- 💡 方案对比:
  - 方案1: [名称-推荐] - [一句话说明]
  - 方案2: [名称] - [一句话说明]
- ⚠️ 风险提示: [如有EHRB或重大风险]

────
🔄 下一步: 请输入方案序号(1/2/3)选择方案

详细方案说明: 如用户需要详细对比，可追问后展开

方案构思 子阶段转换

yaml
复杂任务:
  交互确认模式:
    - 用户选择有效序号(1-N) → 进入详细规划
    - 用户拒绝所有方案 → 输出重新构思询问格式
      - 确认重新构思: 返回方案构思，重新构思
      - 拒绝: 提示"已取消方案设计"，流程终止
      - 其他输入: 再次询问
  推进模式:
    - 选择推荐方案 → 立即静默进入详细规划

简单任务: 直接进入详细规划

重新构思方案询问格式:

code
❓【HelloAGENTS】- 方案确认

所有方案均被拒绝。

[1] 重新构思 - 基于反馈重新设计方案
[2] 取消 - 终止方案设计

────
🔄 下一步: 请输入序号选择

详细规划

前提: 用户已选择/确认方案（来自方案构思）

重要: 必须创建新方案包，使用当前时间戳，不得复用 plan/ 中的遗留方案

动作步骤

所有文件操作遵循G5静默执行规范

1. 创建新方案包目录

yaml
路径: plan/YYYYMMDDHHMM_<feature>/
冲突处理:
  1. 检查 plan/YYYYMMDDHHMM_<feature>/ 是否存在
  2. 如不存在 → 直接创建
  3. 如存在 → 使用版本后缀: plan/YYYYMMDDHHMM_<feature>_v2/
     (如 _v2 也存在，则递增为 _v3, _v4...)
示例:
  - 首次创建: plan/202511181430_login/
  - 同名冲突: plan/202511181430_login_v2/

2. 新库/框架文档查询（如需要）

yaml
触发条件: 方案涉及项目中从未使用过的第三方库/框架，或涉及重大版本升级
执行方式: 使用联网搜索或MCP工具(Context7)查询最新文档
记录位置: how.md 的 技术方案 章节

3. 生成方案文件

读取 templates Skill 获取模板，生成:

  • •why.md (变更提案/产品提案)
  • •how.md (技术设计+ADR)
  • •task.md (任务清单)

任务清单编写规则:

yaml
单任务代码改动量控制:
  - 常规项目: ≤3文件/任务
  - 大型项目: ≤2文件/任务
验证任务: 定期插入
安全检查: 必须包含安全检查任务

4. 风险规避措施制定

  • •基于方案构思风险评估，按G9制定详细规避措施
  • •交互确认模式: 询问用户
  • •MODE_FULL_AUTH=true 或 MODE_PLANNING=true: 规避风险
  • •写入 how.md 的 安全与性能 章节

5. 设置方案包跟踪变量

yaml
设置: CREATED_PACKAGE = 步骤1创建的方案包路径
用途: 在全授权命令中传递给开发实施，确保执行正确的方案包

方案设计 输出格式

⚠️ CRITICAL - 强制要求:

  • •ALWAYS使用G6.1统一输出格式
  • •NEVER使用自由文本替代规范格式
  • •输出前MUST验证格式完整性

严格调用 G6.1 统一输出格式，填充以下数据：

  1. •阶段名称: 方案设计
  2. •阶段具体内容(≤5条要点):
    • •📚 知识库状态
    • •📝 方案概要（复杂度、方案说明）
    • •📋 变更清单
    • •📊 任务清单概要
    • •⚠️ 风险评估（如检测到EHRB）
  3. •文件变更清单:
    • •helloagents/plan/YYYYMMDDHHMM_<feature>/why.md
    • •helloagents/plan/YYYYMMDDHHMM_<feature>/how.md
    • •helloagents/plan/YYYYMMDDHHMM_<feature>/task.md
  4. •下一步建议:
    • •交互确认模式: 是否进入开发实施?（是/否）
    • •规划命令: 方案包已生成，如需执行请输入~exec
  5. •遗留方案提醒:
    • •按G11扫描plan/目录
    • •如检测到遗留方案包（排除本次创建的方案包），按G11规则显示

阶段转换规则

yaml
交互确认模式:
  - 输出总结（包含"🔄 下一步: 是否进入开发实施?(是/否)"）
  - 停止并等待用户明确确认
  - 用户响应处理：
    - 明确确认("是"/"继续"/"确认"等) → 进入开发实施
    - 明确拒绝("否"/"取消"等) → 流程终止
    - Feedback-Delta(提出修改意见) → 按Feedback-Delta规则处理
    - 其他输入 → 视为新的用户需求，按路由机制重新判定

推进模式:
  - 全授权命令: 完成方案设计 → 立即静默进入开发实施
  - 规划命令: 输出整体总结 → 停止 → 清除MODE_PLANNING

关键约束（只有以下3种情况可以进入开发实施）：
  1. 方案设计完成后用户明确确认
  2. 全授权命令(~auto等)触发且已完成方案设计
  3. 执行命令(~exec等)触发且plan/中存在方案包