PlanX Skill：把 AI 规划变成可版本化管理的人类审查物

功能与原则

PlanX 是一个专为 AI 编程 Agent 设计的「规划审查」Skill，核心解决一个常见痛点：Agent 的规划结果往往是一大段聊天记录里的文字，看完就忘，修改无法追溯，审批流于形式。PlanX 将规划从聊天消息升级为可版本化管理、可逐行批注、可对比差异的人类审查物，让「人决定做什么」这件事真正落在代码之前。

设计原则：规划是给人类看的，不是给 Agent 自我安慰的仪式。

认可度

GitHub Star 4（仓库较新，截至 2026-08-25），但 npm 包 @thisisnsh/planx 周下载量达 4,508 次（截至 2026-08-24），已被收录至 Smithery.ai、LobeHub、trending-claude-skills 实时榜单（2026-08-23 更新）等多个主流 Skill 索引平台。产品路线清晰，CI 自动化到位，属于典型「先用起来再等 star 爆发」的项目。

链接

GitHub：https://github.com/thisisnsh/planx

原作者

GitHub 用户 thisisnsh，项目采用 MIT 许可证，维护活跃（2026-08-24 持续更新 CI）。

介绍

AI 编程 Agent（Claude Code、Codex 等）在执行任务前都会先生成一份计划，但这些计划散落在聊天记录里，格式混乱、无版本概念、修改无法对比。PlanX 将整个流程重新设计为「PLAN → REVIEW → REVISE → EXECUTE → RESUME」五个阶段：Agent 根据需求写出结构化规划文档，以版本形式保存；人类在终端 TUI 中逐行批注、直接编辑或折叠章节；反馈返回给 Agent 继续修订，每次修订生成新版本，支持逐词 diff 对比；最终只执行经过人类批准的那个精确版本。

PlanX 还支持跨 Agent 交接：一个 Agent 负责规划，另一个 Agent 负责执行，人为介入的边界清晰。项目 README 本身就是用 PlanX 工作流重建的，属于「吃自己的狗粮」。

特点

• 版本化规划文档：每次修订生成独立版本，支持 word-level diff，变更一目了然
• 逐行批注与直接编辑：将光标放在任意行，按 v 选中、f 批注、e 直接改写，反馈精准到具体决策
• 终端 TUI 审查界面：折叠章节、折叠未改动 diff 段、长规划文件全程可导航，? 显示全部快捷键
• 跨 Agent 交接：规划 Agent 和执行 Agent 可以完全不同，版本文档自带上下文，hand-off 机制清晰
• 一键安装，Agent 通用：npm 全局安装后自动检测 Claude Code / Codex 安装路径并注入 Skill，也支持 npx skills add 方式安装到其他 Agent

使用方法

安装（全局）：

npm install --global @thisisnsh/planx

在 Claude Code 中启动规划：

/planx

在 Codex 中启动规划：

$planx

审查与修订：Agent 捕获规划版本后，在终端运行 planx，按 j/k 导航，v+f 批注，e 直接编辑，s 发送修订，d 对比版本差异，a 选择批准执行。

更新 PlanX：

planx update

使用场景与人群

适用场景：需要对 AI 代码产出做人工把关的团队；大型重构或架构决策前的审查流程；跨团队协作时明确「规划 → 审批 → 执行」边界的场景。

目标用户：Tech Lead / 架构师（想控制 AI 执行方向）、开发团队（需要多人 review AI 规划）、使用多 Agent 流水线的团队（规划 Agent 和执行 Agent 分离）。

输入与输出案例

输入（用户在 Claude Code 中）：

用 PlanX 规划一下把我们的 REST API 迁移到 GraphQL

输出（Agent 捕获的规划版本 v1）：

GraphQL 迁移规划

范围与目标

• 将现有 /users, /posts, /comments 三个端点统一迁移至 GraphQL schema
• 保留 REST 向后兼容（v1 API），新端点走 /graphql
• 迁移顺序：schema 设计 → 迁移 users → 迁移 posts → 迁移 comments → 废弃旧端点
  …（结构化 Markdown，含风险点、依赖、验收标准）

Review 阶段（人类在 TUI 中）：

v 选中「迁移顺序」段落 → f 添加批注：「comments 对 posts 有隐式依赖，建议先迁移 posts 再迁移 comments」→ s 发送修订

Agent 收到反馈后生成 v2，人类用 d 对比 v1 与 v2 diff，确认后按 a 批准执行。

GitHub：https://github.com/thisisnsh/planx

GitHub: https://github.com/thisisnsh/planx