i-doc-final-check
Skill16 starsChanged 2 days agoApache-2.0View on GitHub
docs-only workflow 向けの最終チェック。docs 整合と Issue 状態を確認し、PR に進めるか判定する。
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-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- 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
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 数値) |
issue_ref | str | 人間可読の Issue 参照(GitHub では #<issue_id>) |
step_id | str | 現在のステップ ID |
手動実行(スラッシュコマンド)
$ARGUMENTS = <issue_id>解決ルール
コンテキスト変数 issue_id が存在すればそちらを使用。
なければ $ARGUMENTS の第1引数を issue_id として使用。
issue_ref はハーネス経由ではプロンプトに自動注入される(prompt.py 側で provider 別に整形)。手動実行時は issue_id から #<issue_id> を導出する。
前提知識の読み込み
- docs/dev/docs_maintenance_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 に最終チェック結果をコメントする(verdict marker 付き。下記 Step 5 詳細)
Step 3 詳細: リンク整合性
cd [worktree_dir] && source .venv/bin/activate && make verify-docsexit 0 必須。verify-docs の検査対象には root AGENTS.md も含まれる。
Step 4 詳細: Issue 本文の完了条件更新
Issue 本文に ## 完了条件 セクション(チェックボックス形式)がある場合:
### ワークフロー完了後の確認項目 は PASS 判定と本文更新の対象外とする。
PASS の場合
同サブセクションより前にある workflow 内完了条件のチェックボックスだけを [x] に更新する。
事後確認のチェックボックスは [ ] のまま維持する。
一時ファイルの置き場 [skill_tmp_dir] は、本文を取得する前に
_shared/skill-tmp-resolve.md で 1 回だけ解決する。
解決に失敗した場合(終了コードが非 0、または出力が空)は本文を編集せず ABORT とする。
kaji issue view [issue_id] --json body -q '.body' > "[skill_tmp_dir]/issue-body.md"
# 確認済み条件を [x] に変更
kaji issue edit [issue_id] --commit --body-file "[skill_tmp_dir]/issue-body.md"BACK の場合
チェックボックスは [ ] のまま残す。コメントで未充足条件と戻し先を明示する。
RETRY の場合
本文更新は行わない(軽微修正後に再実行するため)。
Step 5 詳細: 最終チェック結果のコメント
status に関わらず(PASS / RETRY / BACK / ABORT のいずれでも)1 コメントにまとめて投稿する。
--verdict-step final-check --verdict-status <STATUS> は常に付ける(<STATUS> は下記 Verdict 出力で返す
status と一致させる)。1 行目の verdict marker は kaji issue comment が付与する
(shared_skill_rules.md § verdict マーカー契約)。
kaji issue comment [issue_id] --commit \
--verdict-step final-check --verdict-status <STATUS> \
--body-file - <<'EOF'
## docs 最終チェック結果
### 確認結果
- docs / workflow / skill 参照の整合: (結果)
- `make verify-docs`: (終了状態)
- 完了条件: (充足状況。`### ワークフロー完了後の確認項目` は対象外)
- Issue 本文更新: (PASS: 更新済み / それ以外: 未更新)
### 未充足条件・戻し先
(BACK / RETRY / ABORT の場合のみ。未充足条件と戻し先・再実行条件を明示する)
(末尾に、下記「Verdict 出力」で返す内容と同じ verdict block を `---VERDICT---` / `---END_VERDICT---` で囲んで付ける)
EOFVerdict 出力
---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 だけでは解決できない |
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.

