PR・コミット・差分・ファイルをレビューし、再現条件と根拠のある不具合、回帰、検証漏れを報告する。変更が差分の外で何を壊しうるか（影響範囲）を、安全の根拠をコードで証明して確かめるときにも使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
무료GitHub에 공개
how
既存のコードやシステムが今どう動いているか（仕組み、処理の流れ、どこに何があるか、どの層やモジュールが持つべきか）を、コードを読んで説明する。'どうなっているか'、'仕組みを教えて'、'この処理の流れ'、'これはどこに置くべきか'、変更の前に既存の仕組みを理解したいときに使う。
なぜ今の形なのか（経緯）は`why`、技術の選定は`research`を使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(2)
- SKILL.md4.2 KB
- NOTICE.md1.9 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
How
コードベースを読み、「Xはどう動いているか」に答える。担当を引き継いだ経験のあるエンジニアが、その領域で作業を始められるだけの理解を作る。注釈付きのソースコードのような細かさにはしない。
1. 範囲を決める
問いが曖昧なら、自分の解釈を1文で書いて進める。ユーザーは後から直せる。
- 小さい問い（1つのモジュール、小さな関数、狭い問い）: 手順2を省き、読んで直接答える。
- 大きい問い（複数のファイルやサービスにまたがるサブシステム、横断する機能、全体の構成）: 手順2に進む。
迷ったら小さい方で扱う。
2. 観点に分けて読む（大きい問いだけ）
問いを2〜4の観点に分ける（例: 入口から出口までの流れ、データの形、外部との境界）。観点ごとに順に読み、次をメモする。
- 主な部品: 型、サービス、クラス、抽象。名前、ファイル、1文の説明。
- 処理の流れ: どの関数がどのファイルで何をし、次に何を呼ぶか。間を流れるデータ。
- 読んだファイル
- 境界: ほかの部分とつながる場所、入力と出力。
- 意外な点: 見た目と違う動き、歴史的な事情、間違えやすいところ。
- 分からなかった点
参照関係と型はLSPを優先し、rgで補う。観点どうしで食い違ったら、コードを読み直して決める。
3. 要になる主張を確かめる
説明の要になる主張は、file:lineを示せるところまで確かめる。実行して確かめるのが安ければ実行する。外部の状態を変える操作はしない。
4. 説明する
次の形で答える。当てはまらない節は省く。
- 概要: これは何で、何をしていて、なぜあるのか。1〜2段落。ここだけ読めば、続きを読むか決められるようにする。
- 主な概念: 以降を読むのに必要な型、サービス、抽象。短い定義だけ。
- どう動くか: 最も長い節。何がきっかけで、何が順に起き、データがどこへ流れ、どこで分岐するか。疑似コードではなく文章で書き、具体的な関数とファイルの名前を出す。大きなコードの引用は、要点に欠かせない場合だけにする。複数の部品がやり取りする、データが段階的に変わる場合は、図（mermaid、単純なものはテキストの図）を入れる。文章で足りるなら図は入れない。
- どこにあるか: 作業を始めるのに必要なファイルとディレクトリだけ。
- 落とし穴: 見た目と違う動き、意外な振る舞い、歴史的な事情。なければ省く。
- 分からなかったこと: 追い切れなかった点を隠さずに書く。
「UserServiceがAuthClient.refresh()を呼ぶ」のように具体的に書き、「サービスがクライアントに処理を委ねる」のような抽象的な言い方をしない。複雑なものは、なぜ複雑なのかを説明する。単純なものを膨らませない。
短い答えは会話で返す。レビューの対象になる長い説明は、.tmp/research/YYYYMMDD_{topic}.mdに保存する。
サブエージェント
既定では使わない。ユーザーが利用を明示した場合だけ、観点ごとの探索役（手順2のメモの項目を返させる）と、それをまとめて手順4の形で書く説明役に分ける。説明役の出力は、会話の文脈に合わせて手を入れる程度にとどめる。
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
codex
무료Codex CLI（`codex exec`）に、モデル・reasoning effort・速度を指定して作業（調査、レビュー、相談、実装）を頼み、結果を受け取って要約する。「solで〜して」「astra xhighで調べて」「luna low fastで」「Codexで〜」「Codexに聞いて／やらせて」のように、呼び名（sol / astra / luna）やCodexを指定して作業を頼まれたときだけ使う。文中に普通の単語として「sol」「luna」が出てきただけのときは使わない。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
correct
무료エージェントが同じ間違いを繰り返すとき、履歴から間違いの種類を洗い出し、設計、型、lint・CI、テスト、文書の順に、効く範囲で最も上の層で再発を防ぐ。計画を承認してから実装し、各チェックが過去の実際の間違いで失敗することを証明する。'/correct'で使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
アプリを利用者と同じ操作で動かして振る舞いを確かめる、プロジェクト専用の検証スキル（`.claude/skills/verify-<app>/`）と機能一覧を作る。言語、フレームワーク、Web・CLI・API・デスクトップを問わない。'/create-verification-skill'、'このリポジトリの検証スキルを作って'、UI・CLI・サービスの振る舞いを確かめる手順がリポジトリにないときに使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
リポジトリにエージェント開発用の検証基盤を整える。`make check`、GitHub ActionsのCI、短いAGENTS.mdを、言語とツールを検出して作る。'harness-init'、'リポジトリを初期化して'、'検証コマンドを用意して'、新規リポジトリ作成直後や既存リポジトリへの導入時に使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
imozuru
무료知らない分野にキャッチアップするとき、汎用的な言葉から界隈の用語・中心の人・場（学会・雑誌・個人ブログ・動画・リポジトリ・一覧）を特定し、 引用・リンク・著者を芋づる式にたどって、当たりの原文（論文も個人の記事や動画の字幕も）を要約せずそのまま ~/research/<話題>/sources/ に落とす。 周ごとに地図（map.md）を育て、要る主張の全部に原文が付くか飽和したら止める。 見張りのモードでは、地図の場（Qiita・Zenn のタグ、note、YouTube、ブログ、arXiv）の新着を RSS で引いて原文の冒頭つきで並べる。 以下で使用:「芋づる式に調べて」「この分野をキャッチアップしたい」「界隈の用語と人から掘って」 「論文とか先行研究を漁って」「既存の技術を真似したいから元ネタを探して」「上手い人のやり方を集めて」「原文で落として」「/imozuru」 「〇〇って研究あるの？原典ほしい」「全然わからないから流れを掘って」「どういう界隈でどう呼ばれてるか知りたい」 「〇〇の新着見て」「今週の〇〇の記事まとめて」「キャッチアップ」「/imozuru watch」 "dig into this field", "find the canonical papers on X", "literature dive", "what's new in X this week"。 以下には使用しない: 答えが1つの事実の確認（年・有無だけ・仕様1つ → そのまま検索）／ 手元の PC の中の資料を探す／読んだ資料の要約や解説を書く。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트