Communitygithub.com

AdarGit008/baseline-skill

Claude Code向けの /baseline スキル — ゼロ依存のプロジェクト準備チェッカー(69ルール)。~/.claude/skills/baseline にインストール。

baseline-skill とは?

このスキルは、ソフトウェアプロジェクトの品質とセキュリティの最低基準(ベースライン)をコード化して自動検証するためのツールキットです。69のルールはそれぞれ独立したチェックとして実装され、Node.js(v18以上)で動作する軽量なランナーがリポジトリを静的に検査します。ブロッカー(重大な違反)はCIで終了コード1を返し、スクリプトでは判断できない項目(例: 設計判断の影響範囲評価)は日付入りの承認台帳(sign-off ledger)で記録・解決します。主な動作モードは「score(デフォルト)」「init(セットアップ)」「fix(修正)」「explain(説明)」の4つで、Claude Code環境にインストールして `/baseline` のような自然言語コマンドで利用します。信頼性と監査可能性を重視しており、「書かれた約束を信じるな、それをチェックするものを作れ」という哲学に基づいています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add AdarGit008/baseline-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

project-baseline

テスト可能な準備基準: 69のルール。それぞれにチェックが対応し、ゼロ依存のNodeランナーがリポジトリを静的に実行する。ブロッカーはCIで失敗(exit 1)させる。スクリプトでは判断できない判断事項は、日付入りの承認台帳で解決する。要点はこうだ:書かれた約束を信じるな——チェックできるものにしろ。

ツールキットはこのファイルと同じ場所に配置されている:check.mjs(ランナー)、rules.json(69ルール)、config.example.json、templates/、README.md(クイックスタートガイド)、REFERENCE.md(完全なリファレンス:ルール一覧、カテゴリ、アーキテクチャ図、CI設定)、GLOSSARY.md(DevOps/サプライチェーン用語の平易な定義)。

スキルディレクトリを先に解決すること。 以下の $SKILL_DIR は このSKILL.mdを含むディレクトリの絶対パス を意味する—任意のコマンドを実行する前に、そのパスを具体的なパスに解決しておくこと(リテラル文字列 $SKILL_DIR をシェルに渡さないこと)。通常は ~/.claude/skills/baseline である。check.mjs は rules.json を自身のディレクトリから読み込むため、両者は常に同じ場所に置かれていなければならない;ランナーは常に絶対パスで呼び出すこと(node "<abs>/check.mjs" …)。ランナーに必要なのはNode ≥ 18と git のみ;node がない場合は、推測せずにユーザーに伝えること。

呼び出されたとき

ユーザーの言葉から意図を判断し、モードを選択する。デフォルトは score 。

モード: score(デフォルト)— "baselineを実行"、"/baseline"、"このリポジトリをチェック"

  1. ターゲットリポジトリを選択:リクエスト内に明示的なパスがあればそれ、なければ現在の作業ディレクトリ。リポジトリのように見えるか確認する(マニフェストまたは .git があるか)。
  2. ランナーを実行(人間可読):
    node "$SKILL_DIR/check.mjs" --repo <target>
    
    • リポジトリのブートストラップ/テストコマンド(BUILD-05)を実行してはならない場合は --no-exec を追加する(例:信頼できないリポジトリ、テストを実行する時間がない、コマンドが設定されていない)。安全に実行できる場合は、BUILD-05が最重要チェックであるため、実行することを推奨する。
    • ユーザーがエキスパートルール(SBOM、コードスキャン、ミューテーションテスト、シンボル整合性、依存関係脆弱性スキャン、カバレッジ下限)を希望する場合は --profile advanced を追加する。service プロファイルは project_type=service の場合に自動で有効になる。
    • スコアカードを表示する代わりに結果をプログラム的に解析したい場合は --json を追加する。
  3. 結果をユーザーに提示する。ブロッカー(これらはCIで失敗する)を先頭に、次に修正すべき警告を表示する。カテゴリごとにグループ化する。69行すべてをダンプしない—準備率、ブロッカー数、具体的なFAIL/注目すべきWARNとその1行の詳細をまとめて表示する。修正またはスキャフォールディングを提案する。

モード: init — "ここにbaselineをセットアップ"、"標準を導入"、"baselineをスキャフォールド"

  1. ツールキットをリポジトリにコピーする(tools/baseline/ を推奨)。またはその場で参照する。
  2. アーティファクトをスキャフォールドする。ただし、存在しない場合のみ(許可なく上書きしない):
    cp "$SKILL_DIR/config.example.json" <repo>/baseline.config.json
    cp "$SKILL_DIR/templates/CLAIMS.json"   <repo>/docs/CLAIMS.json      # リポジトリが外部に主張(claim)を行う場合のみ
    cp "$SKILL_DIR/templates/start-here.md" <repo>/docs/start-here.md    # ステータス文書が存在しない場合
    mkdir -p <repo>/.project-baseline && cp "$SKILL_DIR/templates/signoff.json" <repo>/.project-baseline/signoff.json
    
  3. baseline.config.json をリポジトリの実情に合わせて編集する:project_type、bootstrap_command(BUILD-05のためのクリーンチェックアウトインストール+テストコマンド)、makes_external_claims(falseにするとCLAIM-*ルールをスキップ)を設定する。オプトインの *_globs キー(freshness/generated/grounding)は、リポジトリがそれらの規約を採用するまで空のままにする。
  4. README.md からCI設定を示し、baseline ジョブを必須チェックにする(これがルールBUILD-06)。
  5. 最初のスコアを実行する。

モード: fix — "baselineの失敗を修正"、"これをグリーンにする"

  1. 最初にスコアを取得する。ユーザーが対処したいブロッカー/警告ごとに、ルール自身の fix フィールド(rules.json から読み取る)をリポジトリへの具体的な編集として適用する—不足しているLICENSEを追加する、アクションをSHAで固定する、.env を .gitignore に追加してシークレットをローテーションする、ネガティブテストを追加するなど。
  2. manual(署名)ルールの場合は、チェックを偽装しない—ユーザーが判断(ブラスト半径、先行技術調査、ウェッジ/モート)を行うのを支援し、.project-baseline/signoff.json に日付付きのエントリを記録する。
  3. 再スコアリングして確認する。

モード: explain — "SEC-03は何をチェックする?"、"なぜCTX-05が失敗した?"

rules.json からルール(各ルールには title、rationale、fix、source、check がある)を読み、それを平易に説明する。加えて、ランナーが実際に何を探したのかも説明する。馴染みのない専門用語(SBOM、SLSA、provenance、sign-off ledgerなど)については、このディレクトリにある GLOSSARY.md に平易な定義がある。

ランナーがどのように判定するか(詳細行を解釈できるように)

  • ルールごとに PASS / FAIL / WARN / SIGN-OFF / SKIP 。blocker のFAILのみが終了コード1を設定する。
  • SKIP はルールが適用されなかったことを意味する:間違った project_type(n/a for <type>)、オフのプロファイル(profile 'advanced' off)、採用されていないオプトイン機能、またはチェックするものがない。SKIPは準備率にカウントされない。
  • プロファイル: core は常に実行される。service は project_type=service の場合に自動実行される。advanced は --profile advanced または設定で profiles:["advanced"] が指定された場合のみ実行される。
  • クレームはオプトイン: CLAIM-* は、クレームレジスタが存在するか、makes_external_claims:true が明示的に設定されている場合のみ実行される。クレームレジスタのないリポジトリがペナルティを受けることはない。
  • 設定は適切に自動検出される。リポジトリルートの baseline.config.json がそれを上書きする。キーは config.example.json にドキュメント化されている。
  • ランナーはゼロ依存(Node ≥ 18 + git)で、クラッシュ耐性がある:チェックを評価できないルールはSKIPにダウングレードされ、実行を停止させることはない。

注意事項

  • 警告をブロッカーとして、またはその逆として提示しないこと—重大度は rules.json とランナーの出力に含まれている。
  • リポジトリが信頼でき、ブートストラップコマンドが設定されている場合は、BUILD-05を実際に実行することを推奨する(--no-exec を省略)。グリーンの最重要チェックは最も強力な単一のシグナルである。
  • 完全な理論的根拠、ルール一覧、カテゴリ説明、アーキテクチャ図、CIスニペットはこのディレクトリの REFERENCE.md にある。ユーザーが深く知りたい場合はそれを読むこと。

関連スキル