用途
project-planner 是一个严格限定为“规划”的技能：它的唯一职责是创建、组织并交付所有规划文档（分析、规划、执行计划、冲刺模板），不会开始实现、执行或推进计划中的任何任务；执行由另一个专门技能负责。
适用于：新功能开发（范围尚未确定）、复杂重构（较大架构变更需谨慎规划）、集成项目（多组件协作）、冲刺规划（将季度目标拆解为可执行任务）、技术调研（实现前需要分析的重型功能）、跨团队计划（需要相关方对齐与阶段跟踪）。
主要能力
- 规划框架：三阶段文档结构（分析 → 规划 → 执行计划）；分层目标（功能 → 阶段 → 目标）；依赖跟踪（任务关系与阻塞）；冲刺模板（可直接用于执行的跟踪文档）。
- 代码库发现：探索项目结构与架构；识别 UI 组件与设计系统；梳理后端模式与约定；检测命名约定、文件组织与代码风格；编目可复用工具、共享模块与设计令牌。
- 分析文档创建：需求记录、资源评估、技术可行性评估、约束识别、现有约定与模式引用。
- 规划文档创建：分步实现策略、按目标分解阶段、资源分配、时间线与依赖映射。
- 执行计划文档创建：按阶段组织的具体任务定义、阶段任务拆解、冲刺/待办模板组织、进度跟踪模板。
- 冲刺模板创建：基于冲刺的待办清单模板、阶段完成检查清单模板、依赖解决跟踪模板、整体项目进度看板模板。
关键规则
- 只做规划：技能完成规划文档后即结束，不进入执行。
- 上下文优先：任何规划决策前必须探索并理解现有代码库，所有提案都要对齐既有模式与约定；不发明已有方案可解决的问题；确实需要新方案时，必须说明现有模式为何不足，并作为有意识的偏离记录。
使用方式
规划前必须执行 Step 0：代码库发现（不可跳过），产出 {output_base}/planning/{project-name}/analysis/CONVENTIONS.md。随后依次产出 ANALYSIS.md、PLANNING.md、EXECUTION.md 与 todos/SPRINT-{N}.md，最后进行交接总结。技能在此停止，不开始实现任何计划任务。
输出位置为中央规划目录：{output_base}/planning/{project-name}/，下设 analysis、planning、execution-plan、todos 子目录。项目文件夹名使用 kebab-case。
配置解析：先检查项目根目录的 cognitive.config.json；若存在则读取 output_base 并用于所有 {output_base} 引用；若不存在，则从当前目录名或 git 仓库名推断项目名，询问用户输出目录（默认建议 ~/obsidian-vault/{project-name}/），创建 cognitive.config.json 并告知用户已保存。配置格式为 {"output_base": "~/obsidian-vault/my-project"}。若无法读取或创建配置，必须先向用户询问明确路径。
文档标准：所有 .md 遵循 obsidian-md-standard，包括通用 frontmatter（title、date、updated、project、type、status、version、tags、changelog、related）、类型（conventions、analysis、plan、execution-plan、sprint-plan、progress）、[[filename]] 形式的 wiki-link、文末 ## Referencias（Parent、Siblings、Children、Input Documents）、冲刺计划作为活文档需更新版本/变更记录/状态、ID 使用 FR-/NFR-、ADR-、T-、双向引用、指标表格格式、毕业门槛复选框、Sprint 2+ 的 Carried Forward。
工作流
- Step 0：代码库发现（必须），产出 CONVENTIONS.md。
- Step 1：分析阶段，产出 ANALYSIS.md。
- Step 2：规划阶段，产出 PLANNING.md。
- Step 3：执行计划文档，产出 EXECUTION.md。
- Step 4：冲刺模板，产出 todos/SPRINT-{N}.md。
- Step 5：交接，汇总所有文档与位置后停止。
限制
本技能不执行任何计划任务，不开始实现、执行或推进工作。除资料中给出的模板、规则、目录与命名约定外，具体界面、平台支持、收费与价格等信息暂未提供。