Plan I

核心用法

plan-i 是 Claude 代码助手的规划流程启动器，专为软件开发场景设计。用户通过自然语言描述需求（如"开发用户权限系统"），工具自动完成三件事：

1. 主题规范化：将描述转化为 kebab-case 命名（如 用户-权限系统 → user-permission-system）
2. 文档初始化：调用 pl-init.sh 创建结构化 Markdown 规划文件
3. 智能预填充：基于用户输入生成包含背景、目标、关键待确认点的初步草案，并立即写入文件

输出采用固定模板，明确提示用户下一步需运行 /plan-c 进入迭代深化阶段。

显著优点

• 零配置启动：无需手动创建文件或学习模板语法，一句话即可触发完整流程
• 上下文预加载：写入文件的初步草案作为"种子"，避免后续对话冷启动
• 强制工作流隔离：通过技能拆分（plan-i 初始化 → plan-c 迭代）确保每个阶段职责单一，防止上下文膨胀
• 安全兜底：内置防覆盖机制，避免误删已有规划

潜在缺点与局限性

• 单轮交互设计：必须一次完成初始化，不支持分步收集信息（如先问主题再问细节）
• 外部依赖：依赖特定 Shell 脚本路径（~/.claude/skills/pl/scripts/pl-init.sh），非 Claude 官方原生能力，跨环境可移植性受限
• 草案质量依赖 LLM：初步规划的深度受限于当前对话上下文，复杂领域可能生成过于笼统的"种子"
• 无可视化反馈：纯文本交互，无图形化规划看板或进度追踪

适合人群

• 使用 Claude Code/Claude Desktop 进行项目开发的工程师
• 需要快速从"想法"过渡到"结构化文档"的技术负责人
• 追求规划流程标准化、可追溯的团队（配合 plan-c 形成完整闭环）

常规风险

• 路径硬编码风险：脚本路径变更将导致功能失效，需配套环境维护
• 命名冲突处理：虽提示更换名称，但用户可能因重复尝试产生混淆
• 过度规划倾向：便捷的启动流程可能诱使对简单任务进行过度形式化规划
• 交接断层：若用户未按提示运行 /plan-c，规划将停留在草案状态，缺乏自动提醒机制

核心用法

plan-i 是一个轻量级的规划启动技能，专为软件开发团队设计。用户通过自然语言描述想要构建或修复的内容，该技能将自动完成以下操作：

1. 智能主题提炼：若用户输入模糊，会通过 AskUserQuestion 工具追问核心意图，并将描述润色为简洁的中文规划主题（如"检索-列表页"），自动处理空格为短横线格式。

2. 一键创建规划：调用 pl-init.sh 脚本在本地 plans/YYYYMMDD/ 目录下生成结构化规划文件，避免手动创建文档的繁琐。

3. AI 辅助初步分析：自动提取用户输入中的核心痛点、目标与待确认点，生成包含背景、目标和关键问题的初步规划草案并立即写入文件。

4. 无缝衔接迭代：输出固定格式的交接指引，明确提示用户下一步运行 /plan-c 技能进行深入代码库分析和规划细化。

---

显著优点

• 零配置启动：无需安装复杂工具，纯 Markdown 驱动，依赖系统内置 bash 命令即可运行。
• 离线安全：完全本地执行，无网络请求，无数据外泄风险，适合企业内网环境。
• 结构化输出：强制生成包含背景、目标、关键问题的规划框架，避免"空白文档恐惧症"。
• 职责单一清晰：严格区分"初始化"与"迭代"阶段，防止单技能过度膨胀，符合 Unix 哲学。
• 防覆盖机制：内置文件名冲突检测，避免意外覆盖已有规划文件。

---

潜在缺点与局限性

• 无代码库感知：本阶段禁止扫描代码库，生成的初步规划完全基于用户输入，可能与实际代码结构存在偏差，需依赖后续的 plan-c 技能修正。
• 脚本路径硬编码：依赖固定路径 ~/.claude/skills/pl/scripts/pl-init.sh，若环境未正确配置将导致失败。
• 交互深度有限：追问仅支持一轮开放式提问，无法像专业需求分析工具那样进行多轮澄清。
• T3 来源风险：维护者为匿名 ownerId，无 GitHub 追溯记录，长期维护和更新存在不确定性。

---

适合的目标群体

• 敏捷开发团队：需要快速启动 Sprint 规划或技术方案设计的 Scrum 团队。
• 独立开发者：个人项目初期快速搭建规划框架，避免过度设计。
• 技术负责人：需要对多个需求进行初步分类和优先级梳理的场景。
• 企业内网环境：对数据安全敏感、禁止外部网络连接的封闭开发环境。

---

使用风险

• 环境依赖风险：若 pl-init.sh 脚本不存在或无可执行权限，将导致规划创建失败。建议使用前验证 skill 安装完整性。
• 文件管理风险：虽内置防覆盖机制，但用户若手动修改 plans 目录结构，可能导致 plan-c 技能无法正确定位文件。
• 规划质量依赖输入：初步分析质量高度依赖用户描述的清晰度，模糊输入将生成同样模糊的规划草案。
• 维护可持续性：T3 级别来源意味着无组织背书，关键业务场景建议 fork 后自行维护。