| name | article-review-apply |
| description | Zenn記事のレビュー成果物を記事本文に反映するワークフロー。採用/保留/却下の自己分類、公開済み記事の注意喚起、PRベースの変更管理を行う。 |
article-review-apply
記事レビュー → 指摘反映 のライフサイクルを扱うスキル。
トリガー
/apply-review <slug> コマンド経由- または
review-applier エージェントから参照
前提条件
reviews/zenn/<slug>.md が既に存在することarticles/<slug>.md が存在すること- main ブランチが最新 (
git pull origin main)
- git identity がリポジトリ規約どおり (
mine_take <s977043@users.noreply.github.com>)
gh active account が s977043 であること（memory/feedback_github_account_s977043.md）
レビュー構成の正本は docs/article-guides/zenn-structure-best-practices.md、レビュー成果物の生成規約は .claude/agents/article-reviewer.md とする。本スキルはそれらを再定義せず、生成済み指摘の採否と反映に専念する。
Zenn 公開フロー上の位置づけ（2026-05-07 以降）
本スキルは 記事本文修正の PR を main ブランチに作成するもので、Zenn deploy のトリガーではない。main への PR マージ後、Zenn 上に反映するには別途 release/zenn ブランチへ流す必要がある（AGENTS.md §「Zenn 公開フロー」、docs/zenn-release-rollout-plan.md）。
| シナリオ | 本スキルの動作 | 後段で必要な操作 |
|---|
published: false 記事の修正 | main に PR、マージ | release/zenn は触らない（公開時に published: true 切替と一緒に流す） |
published: true 記事の修正 | main に PR、PR 本文に ⚠️ バナー | rate-limit 解放後、release/zenn に別 PR で取り込み |
rate-limit 注意: 24h 以内に Zenn publish 系 PR を 5 本以上 release/zenn にマージすると Zenn rate-limit に hit する（memory/reference_zenn_rate_limit_spec.md）。本スキルが連続実行されても main 段階では deploy 発火しないため安全だが、release/zenn への取り込みは別途ペーシング必要。
手順
1. ブランチ作成
git checkout main
git pull origin main
git checkout -b chore/apply-review-<slug>
2. 入力読み込み
reviews/zenn/<slug>.md をReadarticles/<slug>.md をRead- 記事の
published フラグを確認
3. 指摘の分類
review-applier の分類基準に沿って各指摘を採用/保留/却下に仕分け。判定理由を1行で記録。
Zenn 記法活用指摘の採否判断
article-reviewer から :::message / :::details / table などのZenn記法活用が提案された場合は、文面生成や構成判断の有無で採否を分ける。
| 指摘種別 | 判断 | 理由 |
|---|
既存の長い補足を :::details で畳む | 採用 | 既存文を括るだけで文意変更がない場合 |
| 並列・対称な既存情報を table に変換 | 採用 | 情報の並べ替えだけで文意変更がない場合 |
既存の前提段落を :::message で囲う | 採用 | ブロック装飾のみの場合 |
| 固有 SHA / 内部 ID を一般表現に置換 | 採用 | 公開向け一般化で文意を変えない場合 |
「想定読者 / 前提」の :::message を新規作成 | 保留 | 新規文面が必要、著者判断 |
| コアメッセージや中間まとめを新規作成 | 保留 | 要約の切り方が判断依存 |
| 各セクションの目的要約を追加 | 保留 | 文面生成を伴う |
| 「最小導入」など新規章を追加 | 保留 | 構成変更、著者判断 |
例外: 保留区分でも、ChatGPT / 外部レビューの指示書に採用する文面が具体的に記載され、著者意図を変えないと判断できる場合は採用可（PR本文で出典を明記）。
4. 採用分の反映
- 最小差分で Edit を適用
- 周辺テキストの書き換えは禁止
- 複数指摘が同一箇所なら統合
- Zenn記法への置き換えは、auto-applyする場合 文面の追加削除なしを厳守する
5. 検証
- Zenn Front Matter が壊れていないか (
published, title, topics, type, emoji)
- Markdown構文崩れがないか (
grep -n '^#' articles/<slug>.md で見出し確認)
- 可能なら
npx zenn preview を起動してOK（ローカル環境次第）
6. コミット
git add articles/<slug>.md
git commit -m "docs(articles): apply review feedback to <slug>
Apply <N> accepted findings from reviews/zenn/<slug>.md:
- <簡潔なサマリ>
Pending (<M> items) and rejected (<K> items) are captured in the PR body."
コミット作者は実行環境のgit identityを使用する。特定LLMベンダーのCo-Author情報を固定で付与しない。
7. push & PR作成
git push -u origin chore/apply-review-<slug>
gh pr create --title "docs(articles): apply review feedback to <slug>" --body "$(採否一覧テンプレート)"
PR本文は review-applier エージェントの採否テンプレートを使用。
8. 事後処理
- ユーザーのレビュー/マージを待つ（自動マージ禁止）
- 保留・却下項目でユーザー判断後に採用へ変わった場合は追加コミット
ガードレール
エラー回復
- Edit が conflict した場合: 該当指摘は保留に降格し、PR本文に理由記載
- URL 検証失敗時: 技術指摘は保留に降格
- Zenn Front Matter 破損検知時: Edit を巻き戻して該当指摘は保留
成果物
- 1つのPR（
chore/apply-review-<slug>）
- 記事本文の差分
- 採否一覧を含むPR本文
参考
docs/article-guides/zenn-structure-best-practices.md.claude/agents/article-reviewer.md.claude/agents/review-applier.mdreviews/zenn/ai-driven-tdd-nextjs.md- Issue #11
関連 Memory / Learnings
memory/feedback_github_account_s977043.md — gh active account 確認memory/feedback_zenn_publish_rate_pacing.md — 24h あたり 3 本までの分散ルールmemory/reference_zenn_rate_limit_spec.md — rate-limit 仕様、Inquiry 申請手順AGENT_LEARNINGS.md 2026-05-07「Zenn rate-limit はアカウント単位...」AGENTS.md §「Zenn 公開フロー（release/zenn ブランチ経由）」docs/zenn-release-rollout-plan.md — 段階公開計画書
拡張オプション
Codex によるセカンドレビュー委譲
レビューの妥当性に疑問がある場合、codex:codex-rescue agent に「reviews/zenn/.md の指摘の事実整合性を確認」を依頼する。一次情報（外部リポジトリの README / CHANGELOG など）と照合する用途で有効。本スキルから直接起動する仕組みはなく、呼び出し元 Claude が判断する（参考実装: PR #197 / #203）。
