ak110/agent-toolkit

ユーザーが本スキルを明示的に手動起動し、AWI（エージェントワークアイテム）の 具体化と登録を依頼したときだけ、要件の裏付けと対話確定を経て登録する。

問題の診断・原因分析・類似見直し・対策や再発防止の選定を行う前に起動する。 発見工程を問わず、振り返り・WI起草・規範改訂・レビューを含む。 不具合の有無・原因・直し方を述べるか確認で提案する前にも起動する（対処を委譲先やAWIへ委ねる場合を含む）。

変更に着手する直前（検証の基準版を記録する時点）、formatter、linter、testerまたはプロジェクト固有の チェックツールを起動する直前と、変更範囲の検証の対象を選ぶ時点（計画の検証コマンドを書くときを含む）に起動する。

git commit作業（通常commit・amend・fixup）に着手する直前、 push、CI確認、公開工程、リリースに着手する前、 またはコミットメッセージ案（計画ファイル・PR説明など）を書く時点で起動する。

作業を完了したメインエージェントが、作業完了報告と、常時稼働サーバーへの反映、managed-tempの回収、 公開、振り返り、終了までのセッションの完了処理を一続きで行うときに必ず起動する。 単発の調査依頼などへの回答や、単純な事実回答、確認質問、途中報告、待機・失敗報告などでは起動しない。

作業へ着手する前に担当範囲の一部を委譲先へ分けるかと委譲単位を判定する時 （計画の起草前、独立した複数の作業単位か長い工程を含む作業の着手前）、 サブエージェントまたは委譲先を起動、観測、継続もしくは巻き取るとき、または停滞検知・複数のエージェントの調整が必要な場合に起動し、委譲の共通契約と実行手段ごとの契約を提供する。

Claude CodeやCodexのセッション記録をmarkdownに出力・保存する依頼（「会話ログ」「セッション履歴」の出力・保存を含む）で使う。

PR・MR・イシューの作成と本文編集、コメント、レビュー返信、Release本文、チャットやメールへのMCP経由の送信など、第三者が読む外部サービスへエージェントが起草または加筆した人間向けの文面を送る直前に起動する。

GitLab CI設定のキーワード仕様・典型パターン・lint実行方法を参照するときに起動する。 .gitlab-ci.ymlの編集・確認時に起動する。

一時ファイルの置き場所を選ぶ時、および例外用途でmanaged-tempの中へ個別のディレクトリを作成または回収する時に起動する。 版管理または自動同期が有効な設定領域を変更する前に、一時バックアップの置き場所を選ぶ時にも起動する。

対象リポジトリを変更する作業で計画ファイルを作成し、 計画から実装・レビューへ引き継ぐ場合に起動する。 作成要否は本文「計画ファイルの作成要否」に従う。

対象リポジトリのAWIを取得し、レーンへ分けて計画、実装、レビュー、統合および公開を完遂するときに起動する。

pytilpackのモジュール構成・API・extras・CLIの使い方を参照するときに起動する。 import pytilpackを含むコードを読み書きする時に起動する。

agentへのテキスト指示を、バイアスを排して指示どおりに動作するサブエージェントに読ませて改善提案リストを得て、 起動の目的に応じてユーザーとの対話またはエージェントの技術判断で採否を確定して反映する手法。 対象はskill・slash command・タスクプロンプト・CLAUDE.md節・コード生成プロンプトなど。 プロンプトやskillを新規作成・大幅改訂した直後、 または指示と挙動の不一致を評価したい場合に使用する。

コードレビュー・ドキュメントレビューを実施する時、 レビュー指摘・改善提案・ユーザーの割り込みや是正要求・想定外の発見を受領して 採否と修正を確定する時、および提案・自身の判断・サブエージェント出力の妥当性を 評価する時に最初に必ず起動する。外部の記事や資料に基づく改善案の評価にも適用する。 レビュー担当サブエージェント、レビューイーとなる計画担当・実装担当、 およびメインエージェント自身のいずれもが起動する。 著者向けスキルagent-toolkit:writing-standardsと併用する。

リポジトリまたはディレクトリのファイル属性と内容を検索する直前に起動する。

プロジェクトのGit作業ツリー外にある、.env、鍵、証明書などの秘匿値を含むファイルを 読む直前に起動する。Git作業ツリー外のログ、設定ファイル、スクリプト、履歴などの通常のファイルから 秘匿値と見られる値の有無、件数、所在、同一性を探す検索の直前にも起動する。

最上位セッションのメインエージェントが、ユーザーの手動起動、agent-toolkit:completion-reportからの 明示呼び出しまたはagent-toolkit:process-wiの公開工程からの明示呼び出しで起動する。

対象リポジトリのAWIを、レーンへ分けずメインが主作業ツリーでまとめて実装して終端するときに起動する。

本スキルの内容が文脈に無い状態でユーザー発話（自動的なプロンプトを除く）を受けたとき、 応答を始める前に必ず起動する。セッションの最初の発話と、会話圧縮の後に最初に受けた発話がこれに当たる。 操作または判断の確認要否を判定するとき、ユーザー確認またはユーザーへの報告の手段を選ぶとき （Claude CodeのAskUserQuestionとCodexの構造化質問を呼ぶ前を含む）、UWIへ確認を退避するとき、 回答済みUWIを元の作業へ反映するとき、Claude Codeメインが利用上限の猶予通知を受けたとき、 またはツール呼び出しが権限設定もしくはauto mode classifierに拒否されたとき、委譲先の返却がその拒否を報告したときにも起動する。 ユーザーと自分の認識が一致していない可能性があるとき、行動を繰り返し咎められるときにも起動し、認識合わせを行う。

AWIまたはUWIの起草、読解、採否、状態判断および投入時、または対象リポジトリと private-notesを区別してGit操作するときに起動し、人間向けキュー項目の 共通契約と通常の投入手順を提供する。 手動投入専用のagent-toolkit:add-awi-by-userを明示起動した場合を除き、まず本スキルを起動する。

WI処理の工程や運用に関わる問題の原因分析と対策、運用工程や自動化の変更計画、 ユーザーへの運用説明で起動する。キュー、atk wi process-loop、process-wiの1回の実行、確認と回答、振り返りで得た要求を投入する方法を扱う。

ドキュメント・コメント・コード・テストコード・エージェント向け文書 （AGENTS.md・CLAUDE.md・.claude/rules/・.claude/skills/・hooks関連ファイルなど）の 新規作成・修正・計画・レビュー時に最初に必ず呼び出す。 AWI・UWIの本文起草時、成果物へ書く事実主張の裏付け調査時、ホスト機能の可否・入出力契約の調査時、 セッション記録（~/.claude/projects配下）の集計・分析時も呼び出す。 規範・基準・手順・目標値の妥当性、到達性、有無、置き場所を確認する場面でも呼び出す。 理解のためコードを読むだけの場合はトリガー不要。