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"、"このリポジトリをチェック"
- ターゲットリポジトリを選択:リクエスト内に明示的なパスがあればそれ、なければ現在の作業ディレクトリ。リポジトリのように見えるか確認する(マニフェストまたは
.gitがあるか)。 - ランナーを実行(人間可読):
node "$SKILL_DIR/check.mjs" --repo <target>- リポジトリのブートストラップ/テストコマンド(BUILD-05)を実行してはならない場合は
--no-execを追加する(例:信頼できないリポジトリ、テストを実行する時間がない、コマンドが設定されていない)。安全に実行できる場合は、BUILD-05が最重要チェックであるため、実行することを推奨する。 - ユーザーがエキスパートルール(SBOM、コードスキャン、ミューテーションテスト、シンボル整合性、依存関係脆弱性スキャン、カバレッジ下限)を希望する場合は
--profile advancedを追加する。serviceプロファイルはproject_type=serviceの場合に自動で有効になる。 - スコアカードを表示する代わりに結果をプログラム的に解析したい場合は
--jsonを追加する。
- リポジトリのブートストラップ/テストコマンド(BUILD-05)を実行してはならない場合は
- 結果をユーザーに提示する。ブロッカー(これらはCIで失敗する)を先頭に、次に修正すべき警告を表示する。カテゴリごとにグループ化する。69行すべてをダンプしない—準備率、ブロッカー数、具体的なFAIL/注目すべきWARNとその1行の詳細をまとめて表示する。修正またはスキャフォールディングを提案する。
モード: init — "ここにbaselineをセットアップ"、"標準を導入"、"baselineをスキャフォールド"
- ツールキットをリポジトリにコピーする(
tools/baseline/を推奨)。またはその場で参照する。 - アーティファクトをスキャフォールドする。ただし、存在しない場合のみ(許可なく上書きしない):
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 baseline.config.jsonをリポジトリの実情に合わせて編集する:project_type、bootstrap_command(BUILD-05のためのクリーンチェックアウトインストール+テストコマンド)、makes_external_claims(falseにするとCLAIM-*ルールをスキップ)を設定する。オプトインの*_globsキー(freshness/generated/grounding)は、リポジトリがそれらの規約を採用するまで空のままにする。README.mdからCI設定を示し、baselineジョブを必須チェックにする(これがルールBUILD-06)。- 最初のスコアを実行する。
モード: fix — "baselineの失敗を修正"、"これをグリーンにする"
- 最初にスコアを取得する。ユーザーが対処したいブロッカー/警告ごとに、ルール自身の
fixフィールド(rules.jsonから読み取る)をリポジトリへの具体的な編集として適用する—不足しているLICENSEを追加する、アクションをSHAで固定する、.envを.gitignoreに追加してシークレットをローテーションする、ネガティブテストを追加するなど。 manual(署名)ルールの場合は、チェックを偽装しない—ユーザーが判断(ブラスト半径、先行技術調査、ウェッジ/モート)を行うのを支援し、.project-baseline/signoff.jsonに日付付きのエントリを記録する。- 再スコアリングして確認する。
モード: 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にある。ユーザーが深く知りたい場合はそれを読むこと。