name: 规划 description: 当您需要规划可扩展、安全且可维护的技术解决方案时使用。 license: MIT

规划

通过研究、代码库分析、解决方案设计和全面文档创建详细的技术实施计划。

何时使用

在以下情况下使用此技能：

规划新功能实现
架构系统设计
评估技术方法
创建实施路线图
分解复杂需求
评估技术权衡

核心责任与规则

始终遵循 YAGNI、KISS 和 DRY 原则。 诚实、直接、简洁、直击要点。

1. 研究与分析

加载：references/research-phase.md 跳过如果： 提供研究员报告

2. 代码库理解

加载：references/codebase-understanding.md 跳过如果： 提供侦察报告

3. 解决方案设计

加载：references/solution-design.md

4. 计划创建与组织

加载：references/plan-organization.md

5. 任务分解与输出标准

加载：references/output-standards.md

工作流程过程

初始分析 → 阅读代码库文档，理解上下文
研究阶段 → 生成研究员，调查方法
合成 → 分析报告，识别最优解决方案
设计阶段 → 创建架构，实施设计
计划文档 → 编写全面计划
审查与改进 → 确保完整性、清晰度、可操作性

输出要求

不要实现代码 - 仅创建计划
响应时提供计划文件路径和摘要
确保自包含计划，带有必要上下文
包括代码片段/伪代码以澄清
提供多个选项与权衡当适当
完全尊重 ./docs/development-rules.md 文件。

计划目录结构

plans/
└── {date}-plan-name/
    ├── research/
    │   ├── researcher-XX-report.md
    │   └── ...
    ├── reports/
    │   ├── XX-report.md
    │   └── ...
    ├── scout/
    │   ├── scout-XX-report.md
    │   └── ...
    ├── plan.md
    ├── phase-XX-phase-name-here.md
    └── ...

活动计划状态

通过会话状态跟踪当前工作计划来防止版本扩散。

活动与建议计划

类型	环境变量	含义
活动	`$CK_ACTIVE_PLAN`	通过 `set-active-plan.cjs` 明确设置 - 用于报告
建议	`$CK_SUGGESTED_PLAN`	分支匹配，仅提示 - 不要自动使用

工作原理

计划上下文通过以下方式管理：

$CK_ACTIVE_PLAN 环境变量：仅针对明确激活的计划设置（通过会话状态）
$CK_SUGGESTED_PLAN 环境变量：分支匹配计划显示为提示，而非指令
会话临时文件：/tmp/ck-session-{id}.json 仅存储明确激活
SubagentStart 钩子：注入差异化的上下文（活动 vs 建议）

规则

首先检查 $CK_ACTIVE_PLAN：如果设置且有效目录，询问“继续现有计划？[Y/n]”
其次检查 $CK_SUGGESTED_PLAN：如果设置，通知用户“从分支找到建议计划：{path}”
- 这仅是提示 - 不要自动使用它
- 询问用户是否要激活它或创建新计划
如果两者均未设置：继续创建新计划
创建时更新：运行 node .claude/scripts/set-active-plan.cjs plans/...

报告输出位置

所有编写报告的代理必须：

检查由钩子注入的 计划上下文 部分以获取 报告路径
仅 $CK_ACTIVE_PLAN 计划使用计划特定的报告路径
$CK_SUGGESTED_PLAN 计划使用默认 plans/reports/（非计划文件夹）
使用命名：{agent}-{date}-{slug}.md

重要： 建议计划不会获得计划特定的报告 - 这防止旧计划文件夹污染。

质量标准

彻底和具体
考虑长期可维护性
不确定时彻底研究
解决安全和性能问题
使计划足够详细以供初级开发者使用
针对现有代码库模式验证

记住： 计划质量决定实施成功。全面并考虑所有解决方案方面。