| description | docs-only workflow 向けの最終チェック。docs 整合と Issue 状態を確認し、PR に進めるか判定する。 |
| name | i-doc-final-check |
I Doc Final Check
docs-only workflow の PR 前最終ゲート。
現行実装、CLI、運用方針、workflow 定義との整合を確認し、docs-only として PR に進めるかを判定する。
いつ使うか
| タイミング | このスキルを使用 |
|---|
/i-doc-review または /i-doc-verify で Approve 後 | ✅ 必須 |
ワークフロー内の位置: i-doc-update → i-doc-review → i-doc-final-check → i-pr → close
入力
ハーネス経由(コンテキスト変数)
常に注入される変数:
| 変数 | 型 | 説明 |
|---|
issue_id | str | 正規化済み Issue ID(GitHub 数値または local ID) |
issue_ref | str | 人間可読の Issue 参照(GitHub では #<issue_id>、local では bare ID) |
step_id | str | 現在のステップ ID |
手動実行(スラッシュコマンド)
$ARGUMENTS = <issue_id>
解決ルール
コンテキスト変数 issue_id が存在すればそちらを使用。
なければ $ARGUMENTS の第1引数を issue_id として使用。
issue_ref はハーネス経由ではプロンプトに自動注入される(prompt.py 側で provider 別に整形)。手動実行時は issue_id から導出する: GitHub 数値 ID なら #<issue_id>、local-* 形式なら bare ID(# を付けない)。
前提知識の読み込み
- docs/dev/kaji-workflow.md
- docs/dev/workflow_completion_criteria.md
- docs/dev/documentation_update_criteria.md
- docs/dev/shared_skill_rules.md
docs/README.md
実施内容
- worktree と branch を解決する
- docs / workflow / skill 参照の整合を確認する
- links、コマンド例、導線の整合を確認する(
make verify-docs)
- Issue 本文の完了条件を照合し、
### ワークフロー完了後の確認項目 を除く充足状態を更新する
- Issue に最終チェック結果をコメントする
Step 3 詳細: リンク整合性
cd [worktree_dir] && source .venv/bin/activate && make verify-docs
exit 0 必須。verify-docs の検査対象には root AGENTS.md も含まれる。
Step 4 詳細: Issue 本文の完了条件更新
Issue 本文に ## 完了条件 セクション(チェックボックス形式)がある場合:
### ワークフロー完了後の確認項目 は PASS 判定と本文更新の対象外とする。
PASS の場合
同サブセクションより前にある workflow 内完了条件のチェックボックスだけを [x] に更新する。
事後確認のチェックボックスは [ ] のまま維持する。
uv run kaji issue view [issue_id] --json body -q '.body' > /tmp/issue-body.md
uv run kaji issue edit [issue_id] --commit --body-file /tmp/issue-body.md
BACK の場合
チェックボックスは [ ] のまま残す。コメントで未充足条件と戻し先を明示する。
RETRY の場合
本文更新は行わない(軽微修正後に再実行するため)。
Verdict 出力
---VERDICT---
status: PASS
reason: |
docs-only workflow の最終チェックを完了し、PR に進める状態を確認した
evidence: |
make verify-docs 通過、事後確認を除く workflow 内完了条件充足、Issue 本文更新済み
suggestion: |
---END_VERDICT---
status の選択基準
| status | 条件 |
|---|
| PASS | PR に進める(事後確認を除く workflow 内完了条件がすべて充足、本文更新済み) |
| RETRY | final-check 文脈で閉じる軽微修正後に再実行する |
| BACK | docs 更新フェーズに戻す(未充足条件と戻し先を明示) |
| ABORT | docs だけでは解決できない |