RepoProof
新しいユーザーの視点からリポジトリを証明します。READMEを契約として扱い、単なる提案として扱わないでください。
デフォルトワークフロー
node scripts/repoproof.mjs audit . --output repoproof-outputを実行します。repoproof-output/repoproof-report.jsonを読んでから結論を導き出します。- ユーザーが明示的に実行を許可した場合、
node scripts/repoproof.mjs prove . --allow-exec --output repoproof-outputを実行します。 - 修正が要求された場合、
node scripts/repoproof.mjs fix . --dry-run --output repoproof-outputを実行し、repoproof-fixes.patchを確認します。 - 証拠が裏付ける内容のみを報告します。証明されていない主張は未証明としてマークします。
安全ルール
- 監査モードがデフォルトであり、リポジトリコードを実行してはなりません。
- 証明モードには、
--allow-execまたはCIランナーによる明示的なユーザー承認が必要です。 - 公開、デプロイ、プッシュ、マージ、またはユーザーシークレットの読み取りを決して行わないでください。
- 実際のコンテナ、VM、またはOSサンドボックスがない場合、強力なサンドボックス化を主張しないでください。
- 証拠収集と編集には決定論的なスクリプトを使用してください。
リファレンス
- 完全な監査/証明/修正ワークフローについては
references/workflow.mdを参照してください。 - リポジトリコードを実行する前に
references/safety-model.mdを参照してください。 - READMEステップの抽出が不明瞭な場合は
references/extraction-rules.mdを参照してください。 - 編集を提案する前に
references/fix-policy.mdを参照してください。 - レポートを解釈する際は
references/evidence-schema.mdを参照してください。 - CIを追加する前に
references/github-action.mdを参照してください。 - Windows、macOS、Linuxの違いについては
references/platform-notes.mdを参照してください。