incident-cycle
Skill16 starsChanged 2 days agoApache-2.0View on GitHub
第2層のインシデント調査レビュー収束サイクルを 1 コマンドで手動起動する slash command wrapper。kaji run .kaji/wf/official/incident.yaml <incident_issue_id> を Bash 経由で起動し、exit code を verdict に縮約する。
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-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-reviewSkill
- 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 Cycle(slash wrapper)
kaji run .kaji/wf/official/incident.yaml <incident_issue_id> を Bash 経由で起動する slash command wrapper
skill(/review-cycle 同型)。第2層(インシデント原因調査・対応策提案)の手動起動の入口。
- 起動は手動のみ(#303 決定 C)。自動起動・自動昇格は実装しない。
- 全終端は「提案」であり、ラベル遷移・クローズ・統合の実行は人間が行う。close step は無いため
--beforeは使わない。
いつ使うか
| タイミング | このスキル |
| 第1層が起票したインシデントの調査サイクルを 1 コマンドで回したい | ✅ 必須 |
provider.type='github' の環境 | ✅ 前提(incident.yaml は requires_provider: github) |
ワークフロー内の位置: 第1層のインシデント起票 → /incident-cycle →(人間が処遇判断)
入力
/incident-cycle <incident_issue_id>$ARGUMENTS = <incident_issue_id>(第1層が起票したインシデントイシューの番号)。docs/dev/skill-authoring.md§ 手動実行 の規約に従い、引数は$ARGUMENTSから取得する。- 未指定(
$ARGUMENTSが空)の場合はkaji runを実行せず、stderr に usage を出して ABORT verdict を返す。
実行手順
以下の擬似コードを Claude が Bash 経由で実行する。$ARGUMENTS は slash command の引数文字列。
set -u # set -e は外す(exit code を明示的に拾う)
# Step 1: 引数チェック(引数欠落時の ABORT 経路)
read -r ISSUE_ID _REST <<<"${ARGUMENTS:-}"
if [ -z "${ISSUE_ID:-}" ]; then
echo "usage: /incident-cycle <incident_issue_id>" >&2
cat <<'VERDICT_EOF'
---VERDICT---
status: ABORT
reason: |
Missing required argument: <incident_issue_id>.
evidence: |
$ARGUMENTS was empty or did not contain an incident_issue_id token.
suggestion: |
Re-invoke as /incident-cycle <incident_issue_id> (e.g. /incident-cycle 314).
---END_VERDICT---
VERDICT_EOF
exit 2
fi
# Step 2: kaji run 起動
# stderr のみ tee で capture し、^Workflow aborted: シグナルを後で grep する。
STDERR_LOG=$(mktemp)
trap 'rm -f "$STDERR_LOG"' EXIT
kaji run .kaji/wf/official/incident.yaml "$ISSUE_ID" \
2> >(tee "$STDERR_LOG" >&2)
EXIT=$?
HAS_ABORT_MARKER=0
if grep -q '^Workflow aborted:' "$STDERR_LOG"; then
HAS_ABORT_MARKER=1
fi
# Step 3: verdict ブロック出力(exit code → verdict の縮約契約: 0 → PASS / 非 0 → ABORT)
if [ "$EXIT" -eq 0 ]; then
echo
echo "incident-cycle 完了(workflow PASS)。最終提案コメントを確認し、ラベル遷移・クローズ・バグイシュー化・統合の処遇を人間が判断してください。"
cat <<VERDICT_EOF
---VERDICT---
status: PASS
reason: |
incident workflow completed successfully (exit 0).
evidence: |
kaji run .kaji/wf/official/incident.yaml $ISSUE_ID exited with code 0.
suggestion: |
Review the final proposal comment on the incident issue and decide label transition / close / bug-issue drafting / consolidation (human judgement).
---END_VERDICT---
VERDICT_EOF
else
# exit != 0 はすべて ABORT に縮約する。
case "$EXIT" in
1)
if [ "$HAS_ABORT_MARKER" -eq 1 ]; then
REASON="workflow ABORT verdict (exit 1, 'Workflow aborted:' marker present in stderr)"
SUGG="Inspect the incident issue comments for the aborting step's verdict. Re-run with --from review --reset-cycle after human review if the review cycle exhausted."
else
REASON="exit 1 without 'Workflow aborted:' marker — possibly an unexpected exception in cli_main.py"
SUGG="Check stderr / traceback. Re-execute the failing step manually for diagnosis."
fi
;;
2)
REASON="definition error / config error (exit 2)"
SUGG="Run 'kaji validate .kaji/wf/official/incident.yaml'; verify .kaji/config.toml [provider] type is github."
;;
3)
REASON="runtime error in kaji run (exit 3)"
SUGG="Inspect stderr traceback."
;;
*)
REASON="unknown exit code $EXIT"
SUGG="Inspect kaji run stdout/stderr."
;;
esac
cat <<VERDICT_EOF
---VERDICT---
status: ABORT
reason: |
$REASON
evidence: |
kaji run .kaji/wf/official/incident.yaml $ISSUE_ID exited with code $EXIT.
Workflow aborted marker in stderr: $HAS_ABORT_MARKER (1 = present, 0 = absent).
suggestion: |
$SUGG
---END_VERDICT---
VERDICT_EOF
fiexit code → verdict の縮約契約
本 skill は workflow runner の cycle に組み込まれない top-level slash command として動作する。
RETRY / BACK は意味を持たないため、exit 0 → PASS / 非 0 → ABORT の 2 値に縮約する
(exit code の意味は docs/dev/workflow-authoring.md § 終了コード に従う)。
Verdict 出力
上記擬似コードが生成する verdict ブロックを stdout にそのまま出力 すること。
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.

