PR・コミット・差分・ファイルをレビューし、再現条件と根拠のある不具合、回帰、検証漏れを報告する。変更が差分の外で何を壊しうるか（影響範囲）を、安全の根拠をコードで証明して確かめるときにも使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
nokonoko1203/agent-settings922026년 10월 22일 업데이트
무료GitHub에 공개
harness-init
リポジトリにエージェント開発用の検証基盤を整える。`make check`、GitHub ActionsのCI、短いAGENTS.mdを、言語とツールを検出して作る。'harness-init'、'リポジトリを初期化して'、'検証コマンドを用意して'、新規リポジトリ作成直後や既存リポジトリへの導入時に使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
연동 도구GitHub
설치 방법 보기포함된 파일(1)
- SKILL.md4.4 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
リポジトリの検証基盤
エージェントが自分で合否を確かめられる状態を作る。グローバルのstop-check.shは、リポジトリにmake check（または実行可能な.claude/check.sh）があれば、未コミットの変更がある状態での終了時に必ずそれを実行し、失敗したら終了を止める。このスキルはそのcheckと、エージェントの外で同じ判定を行うCIを用意する。
既存ファイルは上書きしない。既存の内容と衝突する場合は差分を示して確認する。commitはしない。
1. 検出
次を読んで、言語、パッケージマネージャ、既存のlint・型・テスト・ビルドのコマンドを特定する。
Cargo.toml、package.jsonとロックファイル、pyproject.tomlとuv.lock、go.modなど- 既存の
Makefile、package.jsonのscripts、justfile、.github/workflows/ - README、CONTRIBUTING、既存のAGENTS.mdやCLAUDE.md
既存の仕組みがあればそれを使う。新しいツールの導入は、ユーザーが求めた場合か承認した場合に限る。
2. make check
lint、型検査、高速なテストを順に実行し、どれかが失敗したら非ゼロで終わるtargetを作る。数十秒以内に終わる範囲に絞り、遅いE2Eや重いビルドはmake test-allなど別targetにする。
例（既存コマンドに合わせて置き換える）:
| 言語 | check |
|---|---|
| Rust | cargo fmt --check、cargo clippy --all-targets -- -D warnings、cargo test |
| TypeScript（bun） | bun run lint、bun run typecheck、bun test |
| Python（uv） | uv run ruff check、uv run ruff format --check、uv run pyright（または既存の型検査）、uv run pytest -q |
Makefileがなく、作る理由もない場合は.claude/check.sh（実行権限付き、set -euo pipefail）にする。作成後に実行し、現状で通ることを確認する。通らない場合は、既存の失敗として一覧を報告し、勝手に直さない。
3. CI
.github/workflows/check.ymlを作る。~/.claude/rules/dependency-security.mdに従う。
make checkをCIでも実行する。ローカルとCIで同じコマンドを使う。- 依存関係のインストールはロックファイルを厳守する（
bun install --frozen-lockfile、uv sync --locked、cargo test --lockedなど）。 - 依存パッケージの脆弱性監査のjobを含める。
- Actionはタグではなくコミットハッシュで固定し、タグをコメントで残す。ハッシュは
gh api repos/<owner>/<repo>/commits/<tag> --jq .shaなどで現在の値を確認する。 permissions: contents: readを既定にする。
監査コマンドやActionの使い方は公式資料かContext7（ctx7）で現在の仕様を確認する。
新規プロジェクトでは、最小リリース期間の設定と、postinstall/preinstallスクリプトの既定ブロックも行う。具体的な設定キーは公式資料かContext7（ctx7）で確認する。
4. AGENTS.md
100行以内で、エージェントが最初に読む地図を書く。CLAUDE.mdしか使わないリポジトリでは、CLAUDE.mdに書くか、@AGENTS.mdを読み込む1行を置く。
書くもの:
- リポジトリの目的を1〜2文
- 主要ディレクトリと責務
- 検証方法（
make check、遅いテストの実行方法） - コードやドキュメントから読み取れない、そのリポジトリ固有の判断基準
書かないもの: 一般的なコーディング規約、lintやhooksで強制できる規則、ユーザーのグローバル設定と重複する内容。守らせたい規則は、文章ではなくlint規則、テスト、hooksに置く。
5. 報告
作成・変更したファイルと、実行したcheckの結果を示す。人間が行う作業として、次を伝える。
- GitHubのブランチ保護（またはrulesets）で、CIの
checkを必須にする - 既存の失敗があれば、その一覧と対応方針
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
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일 업데이트
how
무료既存のコードやシステムが今どう動いているか（仕組み、処理の流れ、どこに何があるか、どの層やモジュールが持つべきか）を、コードを読んで説明する。'どうなっているか'、'仕組みを教えて'、'この処理の流れ'、'これはどこに置くべきか'、変更の前に既存の仕組みを理解したいときに使う。なぜ今の形なのか（経緯）は`why`、技術の選定は`research`を使う。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
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일 업데이트