Skip to content
cccskills
FreePublished on GitHub

harness-init

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

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

Works withGitHub
See how to install

Files included (1)

  • SKILL.md4.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

リポジトリの検証基盤

エージェントが自分で合否を確かめられる状態を作る。グローバルの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
Rustcargo 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を必須にする
  • 既存の失敗があれば、その一覧と対応方針

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

how

Free

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

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