simplify-and-harden-ci

Simplify & Harden CI

インストール

gh skill install pskoett/pskoett-skills simplify-and-harden-ci

Agent Skills CLI を使用する代替手段：

npx skills add pskoett/pskoett-skills/skills/simplify-and-harden-ci

目的

プルリクエストで、Simplify & Harden の CI 専用版を実行します。

• CI でコードを変更しません
• 変更されたファイルのみをレビューします
• 構造化された指摘事項を出力します
• 重大度のゲートに基づいて、マージを任意でブロックできます

対話型またはローカルのコーディングセッションでは、simplify-and-harden を使用します。

コンテキストの制限（重要）

CI エージェントは、変更を書いたコーディングエージェントと同じ最大実装コンテキストを持っているわけではありません。CI の指摘事項は、意図を完全に把握した書き換えではなく、構造化されたレビューシグナルとして扱ってください。

留意点：

• スキャン／レポートとマージゲートを優先してください
• CI でコード変更を自動適用しないでください
• 判断が曖昧な指摘事項は、対話型レビューにエスカレーションしてください

前提条件

1. リポジトリで GitHub Actions が有効になっていること
2. GitHub CLI が認証済みであること（gh auth status）
3. 作成／検証用に gh-aw がローカルにインストールされていること：

gh extension install github/gh-aw

4. GitHub Actions のジョブで、次のコマンドを使って CLI をインストールします：

- uses: github/gh-aw/actions/setup-cli@main
  with:
    version: v0.2.0-beta

CI の契約

CI スキルでは、以下を必ず実施してください。

1. スコープの固定：PR で変更されたファイルのみをレビューする
2. ヘッドレス実行：指摘事項を報告し、パッチやリファクタリングを適用しない
3. 構造化出力：simplify_and_harden のサマリーペイロードを出力する
4. ゲートポリシー：
   • critical：重大な harden の指摘事項がある場合、チェックを失敗させる
   • advisory（任意）：ブロック対象に設定された場合、advisory の指摘事項があるとチェックを失敗させる

作成ワークフロー（gh-aw）

例としてのみ使用するテンプレートは references/workflow-example.md にあります。 自動化を有効にする場合を除き、.github/workflows の外に置いてください。

有効にする場合：

1. references/workflow-example.md のテンプレートブロックを .github/workflows/simplify-and-harden-ci.md にコピーします。（.md 拡張子は意図的なものです。gh-aw ワークフローは Markdown ファイルであり、gh aw compile が GitHub Actions で実際に実行される .lock.yml ファイルにコンパイルします。これは、手書きの標準的な Actions YAML ワークフローではありません。）
2. ワークフローをコンパイルして検証します：

gh aw compile --validate --strict

3. ワークフローの変更をトリガーしてプッシュします：

gh aw run simplify-and-harden-ci --push

4. GitHub Actions でステータス／ログを確認し、PR へのフィードバックが投稿されていることを確認します。

プロンプトテンプレート（CI）

gh-aw ワークフローで、次のプロンプト本文を使用します：

Run Simplify & Harden in CI (headless mode) for this pull request.

Rules:
1) Review only files changed in this PR.
2) Do not modify repository files.
3) Before reporting findings, re-read all changed code with "fresh eyes" and actively look for obvious bugs, errors, confusing logic, brittle assumptions, naming issues, and missed hardening opportunities.
4) Simplify pass: detect dead code, naming clarity issues, control-flow complexity, unnecessary API surface, and over-abstraction.
5) Harden pass: detect input-validation gaps, injection vectors, auth/authz issues, secret exposure, data leaks, and concurrency risks.
6) Document pass: suggest non-obvious rationale comments as findings (do not edit files).
7) Emit structured YAML under key `simplify_and_harden`, including:
   - simplify findings
   - harden findings (critical/advisory split)
   - summary counts
   - `review_followup_required`
   - learning loop candidates for self-improvement ingestion
8) If blocking policy is enabled and matching findings exist, mark the run as failed.

推奨される出力

1. 指摘事項を簡潔にまとめ、重大度順に並べた PR コメント
2. 合格／不合格の理由を含むチェック実行のサマリー
3. 下流の自動化で使用できる、機械可読な YAML アーティファクト

自己改善との連携

self-improvement ワークフローを介して、 simplify_and_harden.learning_loop.candidates を .learnings/LEARNINGS.md に転送し、繰り返し現れるパターンを永続的なエージェントコンテキストルールに昇格できるようにします。