kaji: Skill for Claude Code

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）
provider.type='github' 以外（local 等）	❌ workflow が requires_provider: github で exit 2

ワークフロー内の位置: 第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
fi