核心用法
plan-i 是 Claude Code 技能体系中的规划流程入口，专用于将用户的模糊需求转化为结构化的规划文档。用户只需描述想要构建或修复的内容，系统即可自动完成主题提炼、命名规范化、规划文件创建及初步分析生成。
典型使用场景：
- 新功能开发前的需求梳理
- 系统重构或技术债务处理
- 复杂 bug 修复的方案预研
- 多模块协作项目的架构设计
显著优点
1. 零配置启动：无需手动创建文件或学习模板格式，输入自然语言描述即可触发完整流程
2. 智能命名优化：自动将中文描述转换为符合规范的短横线连接命名（如"检索列表页"→"检索-列表页"）
3. 前置内容生成：在文件创建后立即写入初步规划草案，避免空白文档焦虑，提供可迭代的起点
4. 严格的流程隔离：明确限制为"初始化-only"，强制将深度分析移交至 plan-c 技能，防止单次对话过度膨胀
5. 交接机制清晰：通过固定格式的输出模板，明确告知用户下一步操作指令（/plan-c），降低认知负担
潜在缺点与局限性
- 无代码感知能力：禁用模型调用（
disable-model-invocation: true），无法结合代码库上下文生成规划 - 依赖用户输入质量：初步规划草案的质量高度依赖用户原始描述的完整度，模糊输入可能导致方向偏差
- 单文件限制：仅支持创建单一规划文件，复杂项目需要多次调用或手动拆分
- 冲突处理保守：遇到命名冲突时仅提示更换，无自动版本控制或分支机制
适合人群
- 需要快速启动技术规划的开发团队负责人
- 习惯用 Claude Code 管理开发工作流的全栈工程师
- 追求结构化文档但厌恶重复性初始化工作的效率型开发者
常规风险
- 覆盖风险：虽声明"严禁覆盖"，但仍需依赖脚本
pl-init.sh的内部实现，建议确认脚本含存在性校验 - 上下文丢失：禁用模型调用意味着无法访问对话历史中的代码片段，需在描述中显式包含关键背景
- 过度简化陷阱：自动生成的"初步分析摘要"可能让用户误以为是完整方案，需强调其草稿属性