Token导航 LogoToken导航TokenDH.com
开发需要联网github未标认证来源可访问许可证需确认审计通过

plan-review计划审查

Agent Skill

plan-review 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

447

周安装

19

GitHub Stars

2

下载量

157
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:plan-review(计划审查)
来源仓库:https://github.com/yelban/orz99-skills
仓库路径:skills/plan-review
安装命令:
npx skills add https://github.com/yelban/orz99-skills --skill plan-review
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/yelban/orz99-skills --skill plan-review

简介

plan-review 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在开发协作场景中整理项目状态时使用。

  • 适用于围绕仓库状态、代码变更或协作事项的信息组织与汇总。
  • 通过 npx skills add 命令从 GitHub 仓库安装,需指定技能名称和完整仓库地址。
  • 安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写操作。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

Plan Review

實作前的計畫審查。四個維度逐段檢視,每個議題給選項和建議,確認後才進下一段。

定位:審查計畫本身(任務拆解、方向、風險),不是 code review。程式碼層面的審查請用 /code-review


Step 0: 定位計畫 + 選擇深度

定位計畫

按優先順序尋找:

  1. ARGUMENTS 指定路徑 → 直接讀取
  2. codex-plan.md(當前目錄)→ codex-plan 產出
  3. .claude/plans/ → 取最新的 .md
  4. 都找不到 → 用 AskUserQuestion 請使用者指定

讀取計畫後,摘要核心目標(1-2 句),確認審查對象正確。

讀取相關程式碼

計畫中提到的 Target Files / 修改檔案 → 全部讀取。不看現有程式碼就無法判斷計畫是否合理。

選擇審查深度

用 AskUserQuestion 詢問:

  • 深度審查:每段最多 4 個議題,適合大型功能或架構變更
  • 快速審查:每段最多 1 個議題,適合小改動或時間有限

Step 1-4: 四段審查

依序執行。每段完成後用 AskUserQuestion 確認決策,再進下一段。

第一段:完整性

計畫有沒有漏東西?

  • 任務拆解是否足夠細——每個 task 能在一次 commit 內完成?
  • 任務之間的依賴關係是否正確?有沒有循環依賴或順序錯誤?
  • 是否遺漏必要步驟(DB migration、config 變更、環境變數、文件更新)?
  • Mermaid 依賴圖(如有)是否反映實際依賴?

第二段:方向性

方向對不對?有沒有更好的做法?

  • 現有程式碼是否已能解決問題? 計畫提議建新 service / 新模組 / 新 migration 時,檢查現有程式碼是否已具備所需功能——只需串接或擷取即可。這是最高優先級的檢查:一個洞察就能把 4 個 phase 壓縮成 80 行改動。
  • 選擇的架構模式是否適合問題規模?有沒有更簡單的替代方案?
  • 技術選型是否合理?有沒有跟現有 codebase 的慣例衝突?
  • 修改的檔案清單是否正確?有沒有漏掉該改的檔案,或改了不該改的?
  • 提出的 API / 介面設計是否清晰且一致?

第三段:風險

哪裡可能出事?

  • 哪些步驟風險最高?失敗的後果是什麼?
  • 有沒有 rollback 策略?能不能漸進式部署(feature flag、canary)?
  • 有沒有考慮向後相容?會不會破壞現有使用者或 API 消費者?
  • 測試策略是否覆蓋關鍵路徑?有沒有遺漏的邊界案例?

第四段:範圍

範圍合理嗎?

  • 是否超出原始需求?有沒有偷渡不必要的重構或功能?
  • 是否工程不足?有沒有偷懶跳過該做的事(錯誤處理、輸入驗證、測試)?
  • 任務粒度是否適當?太粗的 task 應拆開,太碎的可合併
  • 估算的複雜度是否合理?有沒有被低估的部分?
  • 計畫是否明確列出「NOT in scope」? 如果沒有,主動建議補上——列出被排除的相關工作及排除理由。這能防止實作時 scope creep,往往比計畫本身更有價值。

議題呈現格式

每個議題必須包含:

  1. 問題描述 — 具體指出計畫中的哪個 task/step,引用檔案路徑(如相關)
  2. 選項 — 2-3 個選項(含「不處理」),每個標明:

- 對計畫的影響(需改幾個 task?加減步驟?) - 風險變化(提高或降低?) - 實作成本變化

  1. 建議 — 推薦的選項及理由

輸出範例

### 1. 完整性:缺少 DB migration 步驟

**問題**:Task 3 新增 `status` 欄位到 User model,但計畫沒有對應的
migration task。部署時會因為欄位不存在而失敗。

**選項**:
- **A) 在 Task 3 前插入 migration task**(建議)
  影響:+1 task,Task 3 加 blockedBy | 風險:降低 | 成本:低
- **B) 合併進 Task 3**
  影響:Task 3 變大 | 風險:不變 | 成本:零
- **C) 不處理**
  影響:無 | 風險:部署失敗 | 成本:零

**建議 A**:migration 獨立一個 task 方便 rollback,且不混淆程式碼變更。

AskUserQuestion 格式

每段結束時用 AskUserQuestion:

  • 選項標籤標示 議題編號 + 選項字母
  • 建議選項放第一個
  • 深度模式範例:1A + 2B + 3A
  • 快速模式直接用選項字母

Step 5: 修訂建議

四段審查完成後,輸出:

## 計畫審查摘要

| # | 維度 | 議題 | 決策 |
|---|------|------|------|
| 1 | 完整性 | 缺少 DB migration | A: 插入獨立 task |
| 2 | 方向性 | 可用現有 middleware 取代自建 | A: 改用現有 |
| 3 | 風險 | 無 rollback 策略 | A: 加 feature flag |
| 4 | 範圍 | Task 7 偷渡重構 | B: 拆到獨立 PR |

### 建議修訂
- [ ] Task 2.5: 新增 migration for User.status(blocked by: Task 2)
- [ ] Task 4: 改用 existing authMiddleware,刪除自建邏輯
- [ ] Task 1: 加 feature flag ENABLE_NEW_AUTH
- [ ] Task 7: 移出計畫,另開重構 PR

### NOT in scope(建議補入計畫)
- **AuthService 重構** — 現行架構足夠,獨立 PR 處理
- **Email 驗證流程改版** — 與本次功能無關,避免牽動範圍
- **舊 API 版本淘汰** — 需協調下游消費者,不適合綁在一起

審查原則

  • 完整但不囉嗦 — 漏步驟要補,但不要把簡單的事搞複雜
  • 最簡單的正確方案 — 有更簡單的做法就提出來
  • 風險意識 — 高風險步驟必須有 fallback
  • 範圍紀律 — 不允許 scope creep,也不允許偷懶

Now Execute

使用者的審查請求見下方 ARGUMENTS:。從 Step 0 開始。

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

32.31%
按下载量换算51

Claude

28.91%
按下载量换算45

Cursor

19.35%
按下载量换算30

Gemini CLI

9.55%
按下载量换算15

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills