核心用法
plan-i 是规划工作流的启动器(Initializer),负责将模糊的用户需求转化为结构化的规划起点。用户通过自然语言描述想要构建或修复的内容,该技能完成三件事:提炼中文主题(用 "-" 连接)、执行 pl-init.sh 脚本创建规划文件、向文件中写入包含背景/目标/待确认点的初步草案。
显著优点
- 零门槛启动:无需预设格式,开放式提问捕获真实意图
- 强制结构化:自动将口语化描述转化为「背景-目标-关键点」的规划雏形
- 状态同步:确保文件写入先于用户输出,避免对话与文件状态不一致
- 清晰交接:固定格式输出 + 明确的
/plan-c触发指引,降低用户认知负担
潜在局限
- 禁用模型调用(
disable-model-invocation: true):无法进行 LLM 驱动的意图分析增强,纯依赖脚本硬逻辑 - 单轮边界:严禁深入代码库扫描,若用户追问实现细节只能拒绝或移交
- 命名刚性:强制 "-" 连接的中文化主题,可能与团队现有英文命名规范冲突
- 无版本控制:脚本层面未提 Git 集成,存在覆盖风险(虽有冲突检测)
适合人群
敏捷开发团队的技术负责人、需要进行代码级规划但不希望从零撰写文档的开发者、以及使用 Claude 作为架构助手的工程组织。
常规风险
| 风险点 | 说明 |
|--------|------|
| 命名冲突 | 同名规划被静默覆盖或阻塞,需人工介入重命名 |
| 意图漂移 | 无 LLM 辅助时,脚本提取的核心意图可能与用户真实需求存在偏差 |
| 交接失败 | 用户未按指引触发 `/plan-c`,导致规划流程中断在半成品状态 |
| 权限问题 | `pl-init.sh` 脚本依赖本地文件系统权限,CI/容器环境可能执行失败 |