Communitygithub.com

Lev-it/lev-skills

沿兩個軸線——標準(程式碼是否遵守儲存庫的編碼標準?)與規格(程式碼是否符合原始議題/PRD 的要求?)——審查自固定點(提交、分支、標籤或合併基準)以來的變更。兩個審查會由平行子代理同時進行,並將結果並排呈現。當使用者想要審查分支、PR、進行中的變更,或要求「審查自 X 以來的內容」時使用。

lev-skills 是什麼?

此技能針對開發分支提供雙軸線審查流程,由使用者指定的固定點(如提交 SHA、分支名稱或標籤)與 `HEAD` 之間的變更差異(diff)進行分析。第一個軸線「標準」檢查程式碼是否遵循儲存庫中記錄的編碼標準(例如 `CODING_STANDARDS.md` 或 `CONTRIBUTING.md`);第二個軸線「規格」則比對程式碼是否忠實實作原始議題、PRD 或規格文件中的要求。兩個審查會由平行子代理獨立執行,以避免上下文交互污染,然後彙總結果。此技能支援所有能使用 git 的專案,並仰賴 `docs/agents/issue-tracker.md` 來擷取議題參考。最終報告以 `## Standards` 和 `## Spec` 區段獨立呈現,並附上每個軸線的摘要與最嚴重問題。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/review

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

對 HEAD 與使用者提供的固定點之間差異的雙軸線審查:

  • 標準 — 程式碼是否符合此儲存庫的文件化編碼標準?
  • 規格 — 程式碼是否忠實實作原始議題 / PRD / 規格?

兩個軸線會作為平行子代理執行,以避免彼此上下文污染,然後此技能會彙總它們的發現。

應已提供議題追蹤器給您 — 如果缺少 docs/agents/issue-tracker.md,請執行 /setup-matt-pocock-skills。

流程

1. 固定固定點

無論使用者指定的是什麼固定點 — 提交 SHA、分支名稱、標籤、main、HEAD~5 等。如果他們沒有指定,請詢問。

一次擷取 diff 指令:git diff <固定點>...HEAD(三點,以便與合併基準進行比較)。同時透過 git log <固定點>..HEAD --oneline 記錄提交清單。

在繼續之前,確認固定點可以解析(git rev-parse <固定點>)且 diff 非空。無效的引用或空的 diff 應在此處失敗,而不是在兩個平行子代理內部。

2. 識別規格來源

尋找原始規格,依此順序:

  1. 提交訊息中的議題參考(#123、Closes #45、GitLab !67 等)——透過 docs/agents/issue-tracker.md 中的工作流程擷取。
  2. 使用者作為引數傳遞的路徑。
  3. 位於 docs/、specs/ 或 .scratch/ 下,且與分支名稱或功能相符的 PRD/規格檔案。
  4. 如果找不到任何內容,請詢問使用者規格在哪裡。如果他們說沒有,規格子代理將跳過並報告「無可用規格」。

3. 識別標準來源

儲存庫中任何記錄程式碼應如何撰寫的內容,例如 CODING_STANDARDS.md 或 CONTRIBUTING.md。

4. 平行啟動兩個子代理

使用兩個 Agent 工具呼叫發送單一訊息。對兩者都使用 general-purpose 子代理。

標準子代理提示 — 包含:

  • 完整的 diff 指令和提交清單。
  • 您在步驟 3 中找到的標準來源檔案清單。
  • 簡報:「報告——在相關的每個檔案/區塊中——diff 中違反文件化標準的每個地方。引用標準(檔案 + 規則)。區分嚴格違規與判斷性問題。跳過任何工具會強制執行的內容。少於 400 字。」

規格子代理提示 — 包含:

  • diff 指令和提交清單。
  • 規格的路徑或擷取的內容。
  • 簡報:「報告:(a) 規格要求但遺失或不完整的需求;(b) diff 中未要求但出現的行為(範圍蔓延);(c) 看起來已實作但實作方式看起來有誤的需求。為每個發現引用規格行。少於 400 字。」

如果缺少規格,請跳過規格子代理,並在最終報告中註明。

5. 彙總

在 ## Standards 和 ## Spec 標題下呈現兩個報告,逐字或經過輕微清理。不要合併或重新排序發現結果——這兩個軸線是刻意分開的(見_為何分為兩個軸線_)。

以一行摘要結尾:每個軸線的發現總數,以及每個軸線內最嚴重的問題(如果有的話)。不要在軸線之間選擇單一贏家——這就是分離旨在防止的重新排序。

為何分為兩個軸線

變更可能通過一個軸線而失敗於另一個軸線:

  • 遵循所有標準但實作了錯誤內容的程式碼 → 標準通過,規格失敗。
  • 完全按照議題要求實作但打破了專案慣例的程式碼 → 規格通過,標準失敗。

分別報告它們可以防止一個軸線掩蓋另一個軸線。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Explores the codebase in the background for context and domain language. Use when user wants to report bugs, do QA, file issues conversationally, or mentions "QA session".

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

相關技能