Skip to content
cccskills
FreePublished on GitHub

how

既存のコードやシステムが今どう動いているか(仕組み、処理の流れ、どこに何があるか、どの層やモジュールが持つべきか)を、コードを読んで説明する。'どうなっているか'、'仕組みを教えて'、'この処理の流れ'、'これはどこに置くべきか'、変更の前に既存の仕組みを理解したいときに使う。

なぜ今の形なのか(経緯)は`why`、技術の選定は`research`を使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md4.2 KB
  • NOTICE.md1.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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の形で書く説明役に分ける。説明役の出力は、会話の文脈に合わせて手を入れる程度にとどめる。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

PR・コミット・差分・ファイルをレビューし、再現条件と根拠のある不具合、回帰、検証漏れを報告する。変更が差分の外で何を壊しうるか(影響範囲)を、安全の根拠をコードで証明して確かめるときにも使う。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

codex

Free

Codex CLI(`codex exec`)に、モデル・reasoning effort・速度を指定して作業(調査、レビュー、相談、実装)を頼み、結果を受け取って要約する。「solで〜して」「astra xhighで調べて」「luna low fastで」「Codexで〜」「Codexに聞いて/やらせて」のように、呼び名(sol / astra / luna)やCodexを指定して作業を頼まれたときだけ使う。文中に普通の単語として「sol」「luna」が出てきただけのときは使わない。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

エージェントが同じ間違いを繰り返すとき、履歴から間違いの種類を洗い出し、設計、型、lint・CI、テスト、文書の順に、効く範囲で最も上の層で再発を防ぐ。計画を承認してから実装し、各チェックが過去の実際の間違いで失敗することを証明する。'/correct'で使う。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

アプリを利用者と同じ操作で動かして振る舞いを確かめる、プロジェクト専用の検証スキル(`.claude/skills/verify-<app>/`)と機能一覧を作る。言語、フレームワーク、Web・CLI・API・デスクトップを問わない。'/create-verification-skill'、'このリポジトリの検証スキルを作って'、UI・CLI・サービスの振る舞いを確かめる手順がリポジトリにないときに使う。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

リポジトリにエージェント開発用の検証基盤を整える。`make check`、GitHub ActionsのCI、短いAGENTS.mdを、言語とツールを検出して作る。'harness-init'、'リポジトリを初期化して'、'検証コマンドを用意して'、新規リポジトリ作成直後や既存リポジトリへの導入時に使う。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

知らない分野にキャッチアップするとき、汎用的な言葉から界隈の用語・中心の人・場(学会・雑誌・個人ブログ・動画・リポジトリ・一覧)を特定し、 引用・リンク・著者を芋づる式にたどって、当たりの原文(論文も個人の記事や動画の字幕も)を要約せずそのまま ~/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 の中の資料を探す/読んだ資料の要約や解説を書く。

The English summary is being prepared. Showing the original description.

nokonoko1203/agent-settings92Updated Oct 22, 2026

See all skills by nokonoko1203

Report a problem with this skill