前言¶
在 Agent 里改仓库，常见情况是模型一边分析一边写文件：方案还没对齐，diff 已经落地。回滚、对照需求、补测试都会变贵。若你希望 Agent 先把任务拆清楚、把风险写明白，并在你点头之后再改代码，就需要一条可重复的「规划门禁」。下面介绍 SkillHub 社区技能 计划模式 plan-mode（@user_5607203c/plan-mode），用 /plan 触发，把会话约束在「先规划、后执行」的只读分析流程里。
这是什么¶
计划模式 plan-mode 是发布者 user_5607203c 在 SkillHub 上架的社区 Skill（分类 ai-agent，版本 1.0.0，标签 requires_api_key=false）。它解决的是：在用户未明确批准前，Agent 不应执行任何会修改仓库或环境的操作；必须先输出结构化计划，等用户确认后再进入实施。
与「直接让模型改代码」相比，该 Skill 把 PLAN MODE 写进技能说明：触发后默认只读分析，修改类操作需等批准。
核心功能¶
依据 SkillHub 页面与 API 资料，已核实能力如下。
- 触发方式：用户输入
/plan时启用本 Skill 所定义的 PLAN MODE。 - 先规划、后执行：在 PLAN MODE 下为只读分析模式；须先完成规划输出，再考虑执行。
- 计划结构：批准前须输出完整计划，包含：
- 任务理解
- 上下文分析
- 实施计划
- 风险点
- 验证方案 - 批准门禁：须等待用户明确批准后，才能执行任何修改操作（写文件、改配置、跑会改状态的命令等，以技能约束为准）。
安装与启用¶
SkillHub 提供两种常见安装路径：把安装提示交给支持 Skill 的 AI 客户端，或使用 skillhub CLI 装到当前 Agent 的 skills 目录。
方式一：通过 AI 安装（官方页面提示）¶
将下面意图发给当前 Agent（安装步骤以 SkillHub 文档为准）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5607203c/plan-mode`。
方式二：skillhub CLI¶
先确认 CLI 是否可用：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（示例来自官方 skillhub.md）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，可能不会被客户端加载。常用路径示例（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
将坐标 @user_5607203c/plan-mode 安装到对应目录，命令形态如下（请将 <skills 目录> 换成上表路径）：
skillhub install @user_5607203c/plan-mode --dir <skills 目录>
安装后按你所用客户端的惯例刷新或重启，使 Skill 被加载。本 Skill 不要求 API Key。
典型用法¶
下面是一条可复现的会话流程，对应官方简介中的触发与门禁说明。
- 在已加载该 Skill 的 Agent 中，对具体任务先输入
/plan，并说明目标（例如：重构某模块、加接口、修缺陷）。 - 等待 Agent 在 PLAN MODE 下输出完整计划，核对五部分是否齐全：任务理解、上下文分析、实施计划、风险点、验证方案。
- 若计划有误或范围过大，在同一模式下补充约束，要求修订计划；仍不应在未批准前看到仓库被修改。
- 用明确措辞批准（例如「按该计划执行」），再让 Agent 进入实施阶段。
示例（用户侧输入，仅作触发演示）：
/plan
请为当前项目增加健康检查接口，不要先改代码，先给完整计划。
批准前 Agent 应停留在分析与规划；批准后才可进行修改类操作。
适用场景与注意¶
适合谁
- 需要在改代码前对齐范围、步骤与验证方式的开发者。
- 高风险变更（数据库迁移、权限、发布脚本）希望先过一遍风险与验证清单的团队。
- 希望减少「Agent 擅自改文件」、便于 Code Review 前置的阅读场景。
限制与注意
- 本 Skill 约束的是 Agent 在 PLAN MODE 下的行为；用户若在批准后仍发送模糊指令，实施阶段仍可能偏离计划，批准时宜写清边界。
- 只读分析依赖客户端与模型对 Skill 的遵守程度；关键环境仍建议配合分支保护与 CI。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 959 次；社区来源，维护节奏以发布者页面为准。
- 与 IDE 内置「Plan / 计划」类模式若并存，以你实际加载的 Skill 与客户端规则为准，避免混用不同入口。
结尾¶
计划模式 plan-mode 把 /plan 与「完整计划 + 明确批准」绑在一起，适合「先想清楚再动手」的 Agent 协作。需要安装或查看说明时，可打开 SkillHub 页面：
- https://www.skillhub.cn/skills/user_5607203c/plan-mode
- https://api.skillhub.cn/user_5607203c/plan-mode
