incident-review
Skill16 starsChanged 2 days agoApache-2.0View on GitHub
第2層。調査 artifact に対する実行型査読。使い捨て検証環境を準備し kaji-incident-reviewer subagent を起動、反証義務・独立検証・受理基準(実証)で判定して査読結果コメントと verdict を発行する。査読結論とレビュー verdict は別軸。
5 other projects use a version of this.
Adopted by
Most recently taken up by
- guang-lee-cn/scaffold-skillstheir own version, first seen Nov 8, 2026
- dfedoryshchev/weftworkstheir own version, first seen Oct 13, 2026
- feverZHONG/liya-incident-reviewtheir own version, first seen Oct 8, 2026
- Tuteliq/claude-plugintheir own version, first seen Aug 10, 2026
- fabianmagrini/skillstheir own version, first seen May 10, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- dfedoryshchev/weftworks★ 5same name
- guang-lee-cn/scaffold-skills★ 2same name
- fabianmagrini/skills★ 1same name
- feverZHONG/liya-incident-review★ 0same name
- Tuteliq/claude-plugin★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- baseline-precheckSkill
- grill-meSkill
- herdr-kaji-launchSkill
- i-dev-final-checkSkill
- i-doc-final-checkSkill
- i-doc-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- incident-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-verifySkill
- i-prSkill
- issue-closeSkill
- issue-createSkill
- issue-designSkill
- issue-fix-codeSkill
- issue-fix-designSkill
- issue-fix-readySkill
- issue-implementSkill
- issue-review-codeSkill
- issue-review-designSkill
- issue-review-readySkill
- issue-small-change-executeSkill
- issue-small-change-reviewSkill
- issue-startSkill
- issue-verify-codeSkill
- issue-verify-designSkill
- kaji-run-verifySkill
- pr-fixSkill
- pr-verifySkill
- releaseSkill
- release-starterSkill
- review-cycleSkill
- review-pollSkill
- reviewSkill
- review-starter-updateSkill
- run-watchedSkill
- series-createSkill
- update-starterSkill
- watch-triageSkill
The file
Files
Incident Review(査読)
調査 artifact に対する実行型査読。main session は環境準備・転記・verdict 発行のみを担い、
検証本体は kaji-incident-reviewer subagent が使い捨て検証環境の中で行う。
判定軸の分離(#303 決定 D): 査読の評価対象は 調査品質のみ(受理基準の充足・反証への耐性・
記述の充足)であり、conclusion の値そのものではない。「結論は INCONCLUSIVE だが棄却仮説・不足証拠・
再現結果の記述が十分なので verdict は PASS」を明示的に許可する。
ワークフロー内の位置: investigate → review →(PASS: report / RETRY: fix)
入力
| 変数 | 型 | 説明 |
issue_id | str | 対象インシデントイシュー ID |
issue_ref | str | 人間可読の Issue 参照 |
step_id | str | 現在のステップ ID |
cycle_count / max_iterations | int | サイクル内ステップのため注入される |
手動実行時は $ARGUMENTS 第 1 トークンを issue_id とする。
共通ルール
.claude/skills/incident-investigate/SKILL.md § 全 incident-* skill 共通ルールに従う
(worktree_dir 非参照 / verdict 3 経路 / foreground + timeout / 副作用禁止 / ログ sanitize /
auto-close hazard 回避)。
受理基準(§ 別軸設計。#303 決定 A / D)
- conclusion が
internal-bug/upstream/environment/transient/duplicateの場合: 実再現、または実障害ログの引用(<run_id>:<ファイル>付き citation)が必須。欠けば RETRY。 - conclusion が
INCONCLUSIVEの場合: 棄却済み仮説(反証根拠つき)・不足証拠の列挙・ 試行した再現の記録が必須。欠けば RETRY。充足していれば PASS(結論がINCONCLUSIVEであること自体は 減点しない)。 risk-acceptedは人間専用語彙。査読結果の語彙に含めない。
実行手順
Step 0: 前提ガード
artifact root を解決する(共通ルール参照。以降のパスはこの絶対 root 基準):
ART="$(kaji config artifacts-dir)"共通ルールの「kind_label の解決」で KIND_LABEL を解決する。解決に失敗したら ABORT する。
成功したら、インシデントイシューのラベルを取得する。
kaji issue view [issue_id] --json labels,body調査 artifact($ART/[issue_id]/investigation/report.md)と直近の調査報告コメントが
存在することを確認する。対象が非インシデント(labels[].name に KIND_LABEL と一致するものがない
(大文字小文字を区別しない)/ identity marker なし)と判明した場合は ABORT。
Step 1: 入力の収集
- 調査 artifact 全文(
$ART/[issue_id]/investigation/report.md)・インシデントイシュー本文・直近の調査報告コメントを読む。 - artifact のメタデータから調査対象 run_id 一覧・提案役モデルを取得する。
Step 2: 使い捨て検証環境の準備
# 例: main の HEAD を detach した一時 worktree。査読後に破棄する。
git worktree add --detach /tmp/kaji-incident-review-[issue_id] HEAD隔離 venv または scratch dir でも可。main checkout を検証で汚さないことが要件。
Step 3: 査読役の起動(capability-based fallback)
docs/dev/development_workflow.md § Pre-Handoff Review と同型の分岐で査読役を起動する。
- 経路 A(subagent): Agent tool で
subagent_type: "kaji-incident-reviewer"を起動する。 prompt に「対象イシュー番号・本文/コメント要約・調査 artifact 全文・検証環境パス・調査対象 run_id 一覧・提案役モデル」を渡す(入力契約の SoT は.claude/agents/kaji-incident-reviewer.md§ 入力)。 - 経路 B(self-review, fallback): Agent tool が使えない runtime / 起動失敗時は、main session が
.claude/agents/kaji-incident-reviewer.mdの rubric を自セッションで適用する。この場合は縮退。
Step 4: 報告の受領と環境破棄
subagent の報告(反証の試行・独立検証・再現の再実行・独立検索・受理可否の推奨
accept / needs-fix / reject・自己申告モデル ID)を受領する。使い捨て検証環境を破棄する:
git worktree remove --force /tmp/kaji-incident-review-[issue_id]Step 5: モデルメタデータの追記(#303 決定 B)
調査 artifact のメタデータセクションのみに、査読役モデル(subagent の自己申告値、取得できなければ
frontmatter の設定値)・査読経路(subagent / main-session)・モデル縮退(提案役モデルと査読役
モデルが同一なら「あり」)を追記する。調査本文は変更しない。縮退時は verdict の evidence にも明記する。
Step 6: 査読結果コメントの投稿と verdict 発行
受理基準(§ 受理基準)と subagent の推奨を突き合わせ、査読結果コメント(verdict マーカー付き)を投稿する。
kaji issue comment [issue_id] --commit \
--verdict-step review --verdict-status <STATUS> \
--body-file <査読結果 markdown>verdict:
| 推奨 / 状態 | verdict | 遷移 |
受理基準を満たす(accept) | PASS | report |
指摘あり・修正で収束可(needs-fix / reject) | RETRY | fix |
| 前提崩壊(対象が非インシデント等) | ABORT | end |
査読結果コメントには指摘を 指摘 N 形式で列挙する(fix が参照する)。
Verdict 出力
---VERDICT--- status: PASS reason: | 受理基準を満たす調査品質を確認した evidence: | 実証(再現 or 実障害ログ引用)あり / INCONCLUSIVE の記述充足。査読経路=<subagent|main-session>、縮退=<あり|なし> suggestion: | ---END_VERDICT---
status の選択基準
| status | 条件 |
| PASS | 受理基準を満たす(調査品質が十分。conclusion 値は問わない) |
| RETRY | 指摘あり。fix で修正して再確認 |
| ABORT | 前提崩壊(対象が非インシデント等) |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

