Communitygithub.com

Lev-it/lev-skills

固定点(コミット、ブランチ、タグ、マージベース)からの差分を「標準」(コードがリポジトリのコーディング標準に従っているか)と「仕様」(コードが元のIssue/PRDの要求を満たしているか)の2軸でレビューします。両方のレビューを並列サブエージェントで実行し、結果を並べて報告します。ユーザーがブランチやPR、作業中の変更をレビューしたい場合、または「X以降をレビューして」と依頼した場合に使用します。

lev-skills とは?

このスキルは、指定された固定点(コミット、ブランチ、タグ、またはマージベース)からHEADまでの差分を2つの独立した軸でレビューします。**標準**軸は、コードがリポジトリの文書化されたコーディング標準に準拠しているかを評価し、**仕様**軸はコードが元のIssue/PRD/仕様を正しく実装しているかをチェックします。両方の軸は並列サブエージェントとして実行されるため、互いのコンテキストを汚染せず、後で結果が統合されます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、`git diff`と`git log`を使用して差分とコミット履歴を取得し、仕様ソースをIssueトラッカーやファイルから特定し、各軸のレポートを生成します。最終的な出力は、標準と仕様のそれぞれの見出しの下に別々のレポートとして表示され、各軸の重要度の高い問題を含む1行の要約で締めくくられます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/review

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

HEADとユーザーが指定した固定点との差分を2軸でレビューします。

  • 標準 — コードはこのリポジトリの文書化されたコーディング標準に準拠していますか?
  • 仕様 — コードは元のIssue / PRD / 仕様を忠実に実装していますか?

両方の軸は並列サブエージェントとして実行されるため、互いのコンテキストを汚染せず、その後このスキルが結果を集約します。

Issueトラッカーが提供されているはずです — docs/agents/issue-tracker.mdがない場合は、/setup-matt-pocock-skillsを実行してください。

プロセス

1. 固定点を特定する

ユーザーが指定した固定点(コミットSHA、ブランチ名、タグ、main、HEAD~5など)を使用します。ユーザーが何も指定しなかった場合は、入力を求めます。

差分コマンドを一度記録します:git diff <固定点>...HEAD(三点ドット。マージベースとの比較になります)。また、git log <固定点>..HEAD --onelineでコミットの一覧も記録します。

先に進む前に、固定点が解決可能であること(git rev-parse <固定点>)と、差分が空でないことを確認します。無効な参照や空の差分の場合は、ここで失敗させます — 2つの並列サブエージェントの中では失敗させません。

2. 仕様ソースを特定する

元の仕様を次の優先順位で探します。

  1. コミットメッセージ内のIssue参照(#123、Closes #45、GitLab !67など) — docs/agents/issue-tracker.mdのワークフローを使用して取得します。
  2. ユーザーが引数として渡したパス。
  3. docs/、specs/、または.scratch/下にあるブランチ名や機能名に一致するPRD/仕様ファイル。
  4. 何も見つからない場合は、ユーザーに仕様の場所を尋ねます。ユーザーが存在しないと言った場合、仕様サブエージェントはスキップされ、「利用可能な仕様がありません」と報告します。

3. 標準ソースを特定する

リポジトリ内でコードの書き方が文書化されているもの(CODING_STANDARDS.mdやCONTRIBUTING.mdなど)。

4. 両方のサブエージェントを並列で起動する

2つのAgentツール呼び出しを含む単一のメッセージを送信します。両方のサブエージェントにgeneral-purposeを使用します。

標準サブエージェントのプロンプト — 以下を含めます。

  • 完全な差分コマンドとコミットリスト。
  • 手順3で見つけた標準ソースファイルのリスト。
  • 指示:「レポート — 該当するファイル/ハンクごとに — 差分が文書化された標準に違反しているすべての箇所を報告してください。標準(ファイルとルール)を引用してください。ハード違反と判断の余地がある違反を区別してください。ツールで強制されるものはスキップしてください。400ワード未満。」

仕様サブエージェントのプロンプト — 以下を含めます。

  • 差分コマンドとコミットリスト。
  • 仕様のパスまたは取得した内容。
  • 指示:「レポート: (a) 仕様が要求したが欠落している、または部分的にしか実装されていない要件; (b) 要求されていないのに差分に含まれている動作(スコープクリープ); (c) 実装されているように見えるが、実装が間違っているように見える要件。各発見に対して仕様の行を引用してください。400ワード未満。」

仕様が見つからない場合は、仕様サブエージェントをスキップし、最終レポートにその旨を記載します。

5. 集約する

2つのレポートを## 標準と## 仕様の見出しの下に、そのまま、または軽くクリーニングして表示します。発見を統合したり、再ランク付けしたりしないでください — 2つの軸は意図的に分離されています(_2軸の理由_参照)。

最後に1行の要約を付けます:軸ごとの総発見数と、各軸内での最悪の問題(ある場合)。軸をまたいで単一の勝者を選ばないでください — それが分離の目的です。

2軸の理由

1つの変更が一方の軸に合格しても、もう一方の軸に不合格になることがあります。

  • すべての標準に従っているが、間違ったものを実装しているコード → 標準合格、仕様不合格。
  • Issueが要求したことを正確に行っているが、プロジェクトの規約を破っているコード → 仕様合格、標準不合格。

これらを別々に報告することで、一方の軸がもう一方の軸を隠してしまうのを防ぎます。

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.

関連スキル