메뉴
review.json の open チケット（annotation）を edit.json への実対応 → edit-lint → チケット更新まで型どおりに執行するスキル。「a-0002 と a-0003 に対応して」「open チケット全部に対応して」で発動する。状態機械（open → addressed + response 必須・resolved 不可侵・黙殺禁止）を bin/respond.mjs が原子的に守る QA ループの消費側。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
analyze-project が作る分析レポート（interpretation.json + analysis-report.html）を一次証拠として読み、方針・素材計画・実行をチャットの明示承認で確定したうえで edit.json v0 とオーバーレイ HTML へ落とすスキル。複数素材の編集計画、素材ゼロからの生成計画（質問対話 → plan.json の仮枠タイムライン確定）、分析結果からカットや BGM・SFX・B ロールを決める依頼で使う。
原稿テキストから VOICEVOX（ローカル・ゼロ円の既製声）または fal Qwen3-TTS（自声クローン）でナレーション音声を生成し、edit.json の audio.narration[] へ書き込むスキル。ナレーションを作ってほしいと頼まれたとき、仮ナレ（下書き試聴）が欲しいとき、声プロファイルを新規に作りたいとき、または既存のナレーションをエンジンや声で差し替えたいときに使う。
動画素材 1 本から 720p プロキシ、ローカル既定の文字起こし（Mac は macOS SpeechAnalyzer / 共通は whisper.cpp・クラウドは承認制）、視認済みキーフレーム、編集イベント、人物関連トラックを作り、analysis.json v0 にまとめるスキル。新しい撮影素材を取り込むとき、素材単体の編集前分析を頼まれたとき、または edit-plan の前処理として素材ごとの分析が必要なときに使う。
プロジェクト内の素材群（analysis.json）と周辺プロジェクト文脈（intake.json・edit.json・planning/・README・過去 PJ）を読み合わせて interpretation.json（解釈層）を作り、事実 + 素材の読みに限定した読み取り専用の分析レポートを描画するスキル。複数素材プロジェクトの内容を素材横断で把握したいとき、analyze-footage が素材ごとの分析を終えたあとの統合、方向性を決める前に一次情報の欠落（取材質問）を洗い出したいときに使う。edit-plan は方針決めの前提としてこのスキルの出力を読む。
承認済み edit.json と edit-lint PASS を入力に、最終 MP4 の計画、明示承認、ローカル書き出し、ffprobe 検証、キーフレーム視認を完了する。編集が承認済みで、納品用動画の書き出しや最終レンダーを求められたときに使う。
録音 review セッションの audio.wav・events.jsonl・edit.snapshot.json・session.json を、analyze-footage と同じ 3 層 STT で文字起こしし、発話区切り・軌跡からの参照解決・命令形への正規化を経て review.json の open annotation とコンパイルレポートへ着地する。喋りながら行った QA セッションをチケット化するとき、recorded / transcribed セッションをコンパイルするとき、または compiled セッションを明示的に再コンパイルするときに使う。
SOC 직업 분류 기준
| name | address-review |
| description | review.json の open チケット（annotation）を edit.json への実対応 → edit-lint → チケット更新まで型どおりに執行するスキル。「a-0002 と a-0003 に対応して」「open チケット全部に対応して」で発動する。状態機械（open → addressed + response 必須・resolved 不可侵・黙殺禁止）を bin/respond.mjs が原子的に守る QA ループの消費側。 |
Language: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
正典: 非公開の内部契約（akari-video-internal）— review-annotations 契約 §1/§3/§5（状態機械）+
review-session 契約 §6（session 由来の増補フィールド）。
open → addressed は必ず response（summary + action +
respondedAt）を伴う。resolved には絶対に書き込まない（人間専用の承認ゲート）。
addressed からの再対応もしない。これらは bin/respond.mjs がプログラムとして拒否する
（ガードを迂回して review.json を手で書き換えない）。declined + 理由を summary
に書いて respond する。判断に迷う場合も、open のまま放置せず declined + 質問を
summary に書く。[要確認] は明示指名されたときのみ対象: text が [要確認] で始まる annotation は
--all-open では対象外（bin/list.mjs が自動でスキップし、スキップした旨を出力する）。
--ids で当該 id を明示したときだけ対象にする。[要確認] はオーナーへの質問であり、
エージェントが勝手に解釈して消化してよいものではない。node packages/edit-lint/bin/edit-lint.mjs <project> --media
が PASS してから respond を打つ（PASS 前に addressed にしない）。対象を列挙する。
node skills/address-review/bin/list.mjs <project-root> --ids a-0002,a-0003
node skills/address-review/bin/list.mjs <project-root> --all-open
出力には sourceT / sourceRange / target（cut:<index> 等）/ text / input に加え、
session 由来（§6 増補）なら session（id・recRange・confidence）と strokes（sessionRef 付き）
を人間可読に整形して表示する。--all-open は [要確認] annotation を自動でスキップし、
スキップした id と件数を出力に含める。
各チケットについて text の指示（source 秒・target が入っている）を読み、対応方針を決める。
node packages/edit-lint/bin/edit-lint.mjs <project-root> --media を PASS させる。判断が確定したチケットごとに状態を執行する。
node skills/address-review/bin/respond.mjs <project-root> \
--id a-0002 --action edited --summary "captions.json に c-0009〜c-0013 を追加。edit-lint --media PASS 確認済み。"
node skills/address-review/bin/respond.mjs <project-root> \
--id a-0003 --action declined --summary "参照素材が assets/ に無いため見送り。素材が揃ったら再度チケットを切ってください。"
respond は対象が open でなければ（resolved / addressed / 未知 id いずれも）拒否し、
summary が空でも拒否する。いずれの拒否も review.json を一切変更しない
（exit code: 成功 0 / ガード拒否 1 / 入力・実行環境エラー 2）。
全 respond 後に対応サマリを 1 枚報告する: 対応 id ごとの action（edited/declined）・
summary の要旨、スキップした [要確認] id、拒否があればその理由。
list.mjs --ids <id,id,...>: 指定 id だけを列挙する（[要確認] も対象に含まれる）。list.mjs --all-open: status: "open" すべてを列挙し、[要確認] はスキップして報告する。list.mjs --json / respond.mjs --json: 機械可読な出力を stdout に出す。respond.mjs --id --action edited|declined --summary "...": 状態遷移の実行器。
respondedAt は実行時刻から自動生成する（ISO8601、上書き不可）。bin/list.mjs: 対象チケットの一覧（人間可読 or --json）。ファイルへの書き込みはしない。bin/respond.mjs: review.json への原子的な状態遷移（open → addressed + response）。
対象以外の annotation・対象の他フィールドはバイト単位で不変。本スキル自体は open チケットへの対応を型どおりに実行する道具である。どの edit.json の変更が 「対応」に当たるかの判断（字幕の正確な範囲、削るべきカット等）はプロジェクトごとに一次情報 （音声・映像・transcript）を確認して行うエージェントの仕事であり、bin が代行しない。