Agent Skillを書く時の心得。SKILL.mdに何を書き、何を書かないかの判断基準と、レビュー指摘の採否の基準を定める。 Agent Skillを作成する時、編集する時、レビュー指摘の採否を決める時に読み込む。
conversation-context-import
対話コンテキストをimportする。`.dev/contexts/` ディレクトリに保存された過去の対話コンテキストを読み込み、開発の継続やレビューに活用する。ユーザーが「コンテキストを読み込んで」「対話コンテキストをimport」「.devのコンテキストを読んで」と言った時に使用する。
含まれるファイル(1)
- SKILL.md4.2 KB
SKILL.md(原文)
インストールする前に、エージェントに与えられる指示の中身を確認できます。
対話コンテキストのimport手順書
.dev/contexts/ に保存された過去の対話コンテキストを読み込む。
手順
1. ブランチ名を取得する
Bashツールで以下を実行する:
git branch --show-current
ブランチ名のサニタイズ
ブランチ名をファイル名として使う際、以下の文字を - に置換する:
/ \ : * ? " < > |
例: dependabot/npm_and_yarn/feed-5.2.0 → dependabot-npm_and_yarn-feed-5.2.0
以降の手順では、サニタイズ後のブランチ名を「サニタイズ済みブランチ名」と呼ぶ。
読み込み元ディレクトリの決定
読み込み元をgit worktreeの状況に応じて決める。
Bashツールで git worktree list を実行し、現在の作業ツリーがmain worktree(リポジトリ本体の作業ツリー)か、リンクされたworktreeかを判断する。worktreeで作業している場合はmain worktreeのパスも把握する。
main treeで作業中の場合は、読み込み元ディレクトリを .dev/contexts/ とする。
worktree内で作業中の場合は、main treeとworktreeローカルの両方の .dev/contexts/ で、カレントブランチ用ファイル({サニタイズ済みブランチ名}.md)の有無を確認して読み込み元ディレクトリを決める:
- 両方に存在する場合: 両方のフルパスを提示し、AskUserQuestionツールでどちらを読み込むか選ばせる。選んだ側の
.dev/contexts/を読み込み元ディレクトリとする - 片方のみに存在する場合: そちらの
.dev/contexts/を読み込み元ディレクトリとする - どちらにも存在しない場合: main treeの
.dev/contexts/を読み込み元ディレクトリとする
以降の手順では、決定したパスを「読み込み元ディレクトリ」と呼ぶ。
2. ファイルの存在確認
読み込み元ディレクトリ内のファイルを確認する。
Globツールで {読み込み元ディレクトリ}/*.md を検索し、以下を把握する:
- カレントブランチと同名のファイル(
{読み込み元ディレクトリ}/{サニタイズ済みブランチ名}.md)が存在するか - それ以外のファイルが存在するか
3. 読み込み対象の決定
ファイルの存在状況に応じて対応を分ける:
カレントブランチのファイルのみ存在する場合
質問せずにそのファイルを読み込む。
他のファイルのみ存在する場合(カレントブランチのファイルが無い)
質問せずに全ファイルを読み込む。
両方存在する場合
AskUserQuestionツールで以下の選択肢を提示する:
- カレントブランチのコンテキストのみ読み込む:
{読み込み元ディレクトリ}/{サニタイズ済みブランチ名}.mdのみ - 全てのコンテキストを読み込む: 読み込み元ディレクトリ内の全ファイル(ファイル名を列挙して提示する)
ファイルが1つも存在しない場合
読み込み元ディレクトリにコンテキストファイルが見つからない旨を報告して終了する。
4. 読み込みと報告
Readツールで対象ファイルを読み込む。
読み込み完了後、どのファイルを読み込んだかをユーザーに報告する:
以下の対話コンテキストを読み込みました:
- `{読み込み元ディレクトリ}/feature-a.md`
- `{読み込み元ディレクトリ}/feature-b.md`
関連スキル
- conversation-context-export: 現在の対話コンテキストを
.dev/contexts/に書き出すスキル。開発の区切りでコンテキストを保存する時に使用する。
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
ソースコード中のコメントを書く時の心得。コメントに何を書き、何を書かないかの判断基準と、置く位置、日本語の文体を定める。 ソースコードのコメントを書く時、直す時、レビューする時に読み込む。
リポジトリのセキュリティ調査を領域ごとに進める。同じサービスを構成する複数のリポジトリを束ねて調査できる。 このsessionは調査を指揮し、領域ごとに起動したsubagentが調査してレポートを出力する。 レポートの問題のトリアージと、問題の自動修正、問題を直すpull requestの状態の同期も指揮する。 複数sessionにまたがる長期作業を想定し、実行するたびに現状を確認して続きの作業を行う。 ユーザーが手動で起動する。
セキュリティ調査で検出された問題を1つ修正し、pull requestをready for reviewまで仕上げる。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
本番に出る前の修正が積まれたrelease pull requestに、デプロイの前後に人間がやる事をまとめたコメントを投稿・更新する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。
リポジトリの1つの領域をセキュリティ観点で調査し、Codexの批判的レビューを経てレポートを出力する。 codepatrol skillが起動したsubagentが実行する。ユーザーが直接呼び出す事は想定していない。