Uh oh!
There was an error while loading. Please reload this page.
refactor: 外部 AI 委譲の Skill を external-ai へ統合 (0-3) - #69
Conversation
- `plugins/ndf-shared/skills/external-ai/` を新設し、外部 AI 委譲の共通手順を集約 - CLI 固有の差分を `references/cli-codex.md` / `references/cli-gemini.md` へ分離 - `plugins/ndf-shared/skills/codex/` と `plugins/ndf-shared/skills/gemini/` を削除 - manifest 3 種から codex / gemini を除き external-ai を追加(claude / codex / kiro すべて) - cross-review / review / qa-security-scan / 各エージェント定義 / 文書の参照を更新 - 生成物を build-runtime-plugins.sh で同期 統合前 917 行(codex 473 + gemini 444)→ 統合後 696 行(SKILL 285 + references 411)で -221 行。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AGejnYyYFuSkQjBhW2KQNy
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 1 | codex | REQUEST_CHANGES
Kiro の --with-codex 導線に削除済み Skill 名への参照が残っているため、移行漏れとして修正が必要です。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 1 | gemini | COMMENT
Skill 統合と各ランタイム (Claude / Codex / Kiro) 向け manifest への反映、既存手順の references/ への整理が適切に行われていることを確認しました。
1 点、既存の直接呼び出しに対する後方互換性の課題についてインラインコメントで修正を提案します。
Uh oh!
There was an error while loading. Please reload this page.
plugins/ndf-kiro/skills/codex/ 削除に伴い、--with-codex で配置される prompts/codex.md が存在しない Skill 名を案内していた問題を修正。 external-ai スキルと references/cli-codex.md を参照するよう変更。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AGejnYyYFuSkQjBhW2KQNy
takemi-ohama
commented
Aug 8, 2026
🔧 /ndf:fix round 1 対応サマリ修正コミット:
修正済み
rejected
検証結果
再レビューをお願いします。 |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 2 | codex | APPROVE
修正必須の新規指摘はありません。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 2 | gemini | REQUEST_CHANGES
統合自体は丁寧に行われており、各種ドキュメントやスクリプト内の参照も漏れなく更新されています。
ただし前回ラウンドで指摘した利用者向けの後方互換性(移行アナウンスまたは stub 追加)のみが未対応です。修正をお願いします。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
commented
Aug 8, 2026
🔧 /ndf:fix round 2 対応サマリ修正コミット: なし(コード変更を要する指摘がなかったため。HEAD は round 1 と同じ
レビュー結果
rejected[major / 後方互換性] README への Breaking Changes 記載 / deprecation stub(gemini 指摘、round 1 から継続) 旧 Skill 名から新 Skill 名への移行案内は Task 0-4 から 0-6 でさらに Skill 名が変わるため、本 PR で先行記載すると後続 PR ごとに書き換えが発生し Task 0-10 と競合します。deprecation stub は Skill 数削減と重複排除という棚卸の意図に反するため不採用です。 round 1 と同一の判断であり、同じ指摘の反復となったため、理由を reply したうえで両スレッドを Resolve しました。方針そのものへのご異論は Task 0-10 の設計として扱います。 独自検証: 旧 Skill 名の残存参照指摘の前提である「既存スクリプトやエージェントからの呼び出しが壊れる」点について、追跡対象ファイルを再検索しました。生きた参照は残っていません。ヒットしたのは次の 2 件のみで、いずれも修正不要と判断しています。
round 1 で修正した Kiro のプロンプト以外に、実行時に「skill not found」を引き起こす参照は存在しません。 検証結果
再レビューをお願いします。 |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 3 | codex | REQUEST_CHANGES
公開済み Skill 名の削除に対する後方互換性または利用者向け移行手順が不足しています。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 3 | gemini | APPROVE
Skill 統合・削除の網羅性(統合元の手順、参照漏れ、各ランタイム配布物への反映)を重点的に確認しました。
codex/geminiのexternal-aiへの統合と各ランタイムの manifest 更新が正しく行われています。- ドキュメントやスクリプト内の古い Skill 参照も適切に書き換えられており、懸念点はありません。
全体として、変更範囲が一貫しており重複や参照漏れは見当たりませんでした。このままマージして問題ありません。
takemi-ohama
commented
Aug 8, 2026
🔧 /ndf:fix round 3 対応サマリ修正コミット: なし(コード変更を要する指摘がなかったため。HEAD は round 1 と同じ
レビュー結果
rejected[major / 後方互換性] 指摘の前提「既存利用者の 1. 本 PR の base は 2. version bump は Task 0-10 に明示的に割り当て済みです。 3. deprecation stub は不採用です。 stub も manifest への登録が必要でコンテキストを占有し、Skill 数の削減と重複排除という棚卸そのものの目的を打ち消します。移行案内は release plan のとおり 前提の誤認に基づく指摘のため、本スレッドは Resolve せず判断の記録として残しました。 独自検証: 旧 Skill 名の残存参照(再実施)追跡対象ファイルを再検索し、生きた参照が残っていないことを確認しました。
round 1 で修正した 検証結果
コード変更がないため push はありません( |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 4 | codex | REQUEST_CHANGES
corder 側の Codex CLI 実行例が、統合後の external-ai 手順と矛盾しているため修正してください。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 4 | gemini | REQUEST_CHANGES
skills/codexとskills/geminiを公開 manifest から削除したため、既存利用者の/ndf:codexや/ndf:gemini呼び出しが「skill not found」エラーになる破壊的変更となります。README.mdの「主な変更」節等へ移行手順を明記するか、旧ディレクトリに軽量な deprecation stub を残して誘導してください。
`corder` エージェントの Codex CLI 実行例が `ps -p <PID>` による終了確認を案内していたが、 Codex は zombie (defunct) 化して `ps -p` が 0 を返し続けるため完了判定を誤る。 `skills/external-ai/references/cli-codex.md` と同じ運用へ揃える。 - 完了検知を stderr 末尾の `^tokens used$` sentinel 待機へ変更 - プロンプトに最終出力ファイル (`apply_patch` 書き出し) を明示する例を追加 - 成果物回収をファイル → stdout → stderr の三段フォールバックへ変更 - `--config reasoning.effort=medium` を起動例に追加 - `ps -p` を使わない旨を注意書きとして明記 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AGejnYyYFuSkQjBhW2KQNy
takemi-ohama
commented
Aug 8, 2026
🔧 /ndf:fix round 4 対応サマリ修正コミット:
レビュー結果
修正済み[minor / 正確性]
例を
あわせてリポジトリ全体で rejected(Resolve 済み)[major / 後方互換性] round 1〜4 で計 4 回いただいた同趣旨の指摘です。判断は変わらないため、根拠を reply に記載したうえで Resolve しました。
方針そのものへのご異論は、本 PR ではなく Task 0-10 の設計として扱わせてください。 その他の意図的な非対応
検証結果
未 Resolve スレッドは 0 件です。再レビューをお願いします。 |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 5 | codex | APPROVE
新規の修正指摘はありません。既存コメントと重複する指摘は追加していません。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 5 | gemini | REQUEST_CHANGES
総評:旧スキル(codex / gemini)の manifest からの削除に伴う後方互換性への対処が漏れています。詳細はインラインコメントを参照してください。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
commented
Aug 8, 2026
cross-review round 5 まとめ(収束)
未 Resolve スレッドは 0 件になりました。コード修正はありません。 決着した論点gemini の指摘は「 懸念そのものは正しいものの、対応主体が本 PR ではないと判断し、Task 0-10 への引き継ぎをもって決着としました。
引き継ぎ先
方針そのものへのご異論は、本 PR ではなく Task 0-10 の設計としてお願いします。 |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 6 | codex | APPROVE
修正必須の新規指摘はありません。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 6 | gemini | REQUEST_CHANGES
plugins/ndf-shared/skills/qa-security-scan/03-report-template.mdのコード例を最新の Codex CLI 連携ルール(ファイル書き出し必須・reasoning.effort=medium)に同期してください。
なお、旧コマンド名削除による破壊的変更の懸念については、Task 0-10(PR #76)の担当範囲として理解・了承しました。
Uh oh!
There was an error while loading. Please reload this page.
`plugins/ndf-shared/skills/qa-security-scan/03-report-template.md` の Codex CLI 呼び出し例が `external-ai/references/cli-codex.md` の規約と 矛盾していたため、corder.md と同じ形へ揃えた。 - プロンプトに `apply_patch` での出力ファイル書き出し指示を追加 - 起動時に `--config reasoning.effort=medium` を指定 - 完了検知を `^tokens used$` sentinel 待機に変更 - 回収をファイル → stdout → stderr の三段フォールバックに変更 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AGejnYyYFuSkQjBhW2KQNy
takemi-ohama
commented
Aug 8, 2026
🔧 cross-review round 6 対応サマリcommit: レビュー結果
対応した指摘(1/1)
Codex CLI 実行例が、本 PR で整理した
横展開確認(追加調査)
検証結果(すべて green)
deferred
|
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 7 | gemini | APPROVE
統合の網羅性と各ランタイムへの配布設定の反映は非常によくできており、問題ありません。1 点だけ README.md の記載で数字の不整合がありましたので指摘します。
Uh oh!
There was an error while loading. Please reload this page.
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 7 | codex | REQUEST_CHANGES
Gemini CLI の headless 実行例に trusted directory 対策の反映漏れがあります。統合後の外部 AI 手順として、既存 launcher と同じ前提を明示してください。
Uh oh!
There was an error while loading. Please reload this page.
並行 PR (#68 review/fix 系統合、#71 ブラウザ自動テスト集約、#72 Skill 削除) が 先に release へ入ったため、本ブランチの external-ai 統合と競合していた。 競合解消方針: - manifest / plugin.json の skills は両ブランチの削除を両方反映 (積集合)。 release が消した review-branch / review-pr-comments / resolve-pr-comments / browser-test と、本ブランチが消した codex / gemini をいずれも除去し、 release が追加した playwright-authoring と本ブランチの external-ai を残した。 - review / cross-review SKILL.md は release 側の再構成をベースに採用し、 本ブランチの /ndf:codex /ndf:gemini → /ndf:external-ai 参照差し替えを再適用。 - README.md の Skill 一覧と個数は plugins/ndf-shared/skills/ と manifest の 実数から数え直した (元Skills 32個 / Claude 23・Kiro 23・Codex 25)。 - plugins/ndf-{claude,codex,kiro}/skills/ は共有側を直したうえで scripts/build-runtime-plugins.sh で再生成。
- cli-gemini.md の headless 起動例をすべて `GEMINI_CLI_TRUST_WORKSPACE=true` + `--skip-trust` 併用へ揃えた。 未登録パス (worktree 等) は untrusted 判定で `--yolo` が `default` へ降格し、 非対話では承認待ちのままハングするため、環境変数とフラグの両方が要る。 実装根拠は cross-review の scripts/launch-gemini.sh の起動行。 - 承認モード節・Q1 / Q3 / Q4 のトラブルシューティングも同じ前提へ更新。 - external-ai/SKILL.md の CLI 比較表から「Gemini は追加フラグ不要」の記述を外した。 - README.md の元Skills 個数を plugins/ndf-shared/skills/ の実体 32 個、 runtime 別 core 個数を manifest の実数 (Claude 23 / Kiro 23 / Codex 25) に合わせた。
takemi-ohama
commented
Aug 8, 2026
🤖 cross-review round 7 対応 + release ブランチ取り込み指摘対応 (2 件)
release/skill-inventory の取り込み先行マージ済みの #68(review / fix 系統合)・#71(ブラウザ自動テスト集約)・#72(Skill 削除)と競合したため、両ブランチの削除を両方反映する(積集合) 方針で解消しました。
マージ後の Skill 実数
残存参照の確認
検証コミット: |
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 8 | codex | APPROVE
修正が必要な指摘はありません。Skill 統合後の参照更新、3 ランタイムの manifest / 生成物同期、Markdown link / runtime plugin validation を確認済みです。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 8 | gemini | REQUEST_CHANGES
統合漏れはありませんが、既存の利用者が躓く「後方互換性」への対応と、Kiro CLI 固有のパス解決に関する課題が見つかりました。
利用者が混乱せず安全に external-ai に移行できるよう対応をお願いします。
Uh oh!
There was an error while loading. Please reload this page.
| codexスキルの手順に従って実行してください。引数があればそのまま使用します。 | ||
| external-aiスキルの手順に従って実行してください。Codex CLI 固有の呼び出し方法は | ||
| `skills/external-ai/references/cli-codex.md` を参照します。引数があればそのまま使用します。 |
There was a problem hiding this comment.
[minor / 正確性]
Kiro 環境では Skill はワークスペース直下ではなく .kiro/skills/ に配置されます。単に skills/external-ai/references/cli-codex.md と書くと、AI がワークスペース直下の skills ディレクトリを探して参照に失敗する恐れがあります。.kiro/skills/external-ai/references/cli-codex.md のように Kiro での実際の配置パスを明記するか、単に「external-ai スキルの references/cli-codex.md」と記述することをお勧めします。
Kiro では Skill はワークスペース直下ではなく .kiro/skills/ に配置されるため、 skills/external-ai/... と書くと参照に失敗しうる。Skill 名からの相対参照と Kiro での実配置パスの両方を示す形へ改めた。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 9 | codex | APPROVE
修正必須の指摘はありません。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 9 | gemini | APPROVE
Skill の統合・削除の網羅性、および各ランタイム (Claude Code, Codex, Kiro) の manifest (*-skills.txt) やビルドスクリプトへの反映漏れがないことを確認しました。リンク整合性チェッカも通過しており、変更は完全かつ一貫しています。
追加の修正を要する箇所はありません。
release ブランチ側の git 系統合 (PR #70) と本ブランチ側の external-ai 統合の 双方を反映した。README の Skill 一覧と個数を実体へ一致させ (shared 29 / claude 20 / codex 22 / kiro 20)、プラグイン一覧表の外部 AI 委譲の記述は /ndf:external-ai を指す形にした。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 10 | codex | APPROVE
新規の修正指摘はありません。参照漏れ、生成物同期、Markdown リンク、runtime plugin validation を確認済みです。
takemi-ohama
left a comment
There was a problem hiding this comment.
🤖 cross-review | round 10 | gemini | APPROVE
PR の目的(Skill の統合と廃止)が 3 つのランタイム(Claude Code / Codex / Kiro)すべてにおいて一貫して実装されています。マニフェスト(plugin.json, *-skills.txt)、Kiro の install.sh やプロンプト群、各種 Agent の定義から削除・統合対象への参照が適切に置換・除去されていることを確認しました。
1 点のみ、新設されたバックグラウンドプロセスの完了待機ループにおいて、プロセス異常終了時の無限ループを避けるためのフェイルセーフに関する改善提案をインラインに残しました。
| until ! ps -p $PID; do sleep 30; done | ||
| # ✅ zombie 安全 | ||
| until grep -q '^tokens used$' /tmp/codex-err.log 2>/dev/null; do |
There was a problem hiding this comment.
[major / 信頼性] Codex プロセスがメモリ不足等で異常終了し ^tokens used$ が出力されなかった場合、この until grep は無限ループになります。タイムアウト用のカウンタ(例: i=0; while [ $i -lt 120 ]; do ... i=$((i+1)); done)を併用してフェイルセーフを設けることを推奨します。
Uh oh!
There was an error while loading. Please reload this page.
概要
Task 0-3。
codexとgeminiの 2 Skill をexternal-ai1 個へ統合した。外部 AI へ委譲する判断基準・プロンプト設計・バックグラウンド実行・成果物回収といった両者に共通する手順を
SKILL.mdに集約し、起動フラグ・完了検知・既知の落とし穴などツール固有の差分をreferences/へ分離した。plugins/ndf-shared/skills/external-ai/SKILL.mdplugins/ndf-shared/skills/external-ai/references/cli-codex.mdplugins/ndf-shared/skills/external-ai/references/cli-gemini.md統合前後の行数
単純連結ではなく、重複記述(プロンプト設計、待機間隔のチューニング、レビュー/コード生成テンプレート、共通のトラブルシューティング、機密情報とコストの注意)を落として再構成した。
skills/codex/SKILL.mdskills/gemini/SKILL.mdskills/external-ai/SKILL.mdreferences/cli-codex.mdreferences/cli-gemini.md-221 行(-24%)。
SKILL.md単体は 285 行で 500 行上限に収まる。manifest への追加理由
統合前の配布状況は
codexが claude / kiro、geminiが claude のみだった。統合後のexternal-aiは claude / codex / kiro の 3 つすべてに載せている。codexだけを配ってgeminiを落とすといった分割ができないwhich codex/which gemini)を含む/ndf:cross-reviewから gemini を起動するため、Codex 向け配布にも外部 AI 委譲手順が要る結果として公開 Skill 数は Claude 29 → 28、Kiro 28 → 28、Codex 30 → 31 となる。
並び順は各 manifest の規則に従った(claude / kiro は用途順で旧
codexの位置、codex はアルファベット順でdocker-container-accessとfixの間)。更新した参照箇所
grep -rn 'ndf:codex\|ndf:gemini\|skills/codex\|skills/gemini'で洗い出し、次を更新した。plugins/ndf-shared/skills/cross-review/SKILL.md/ndf:external-ai1 行へ集約し、CLI 別 reference を併記plugins/ndf-shared/skills/review/SKILL.mdcodex/gemini指定時の委譲先をreferences/cli-codex.md/references/cli-gemini.mdへ変更(4 箇所)plugins/ndf-shared/skills/qa-security-scan/03-report-template.mdplugins/ndf-shared/manifests/{claude,codex,kiro}-skills.txtcodex/geminiを削除しexternal-aiを追加plugins/ndf-claude/.claude-plugin/plugin.jsonskills配列を./skills/external-aiへ差し替えplugins/ndf-claude/agents/{corder,director,qa,debugger,devops-engineer,researcher}.mdAGENTS.md/KIRO.md/README.mddocs/ndf-plugin-reference.md/docs/specifications/ndf-knowledge-and-kiro.mdplugins/ndf-claude/README.mdplugins/ndf-{claude,codex,kiro}/skills/配下はscripts/build-runtime-plugins.shの生成物のため直接編集せず、ビルドで同期した。一方agents/README.md.claude-plugin/plugin.jsonはビルド対象外の編集元のため直接更新している。issues/配下とdocs/superpowers/plans/の過去プラン文書は履歴のため書き換えていない。Test plan
bash scripts/build-runtime-plugins.sh— 生成物を同期bash scripts/build-runtime-plugins.sh --check—runtime plugin generated files are up to datepython3 scripts/check-markdown-links.py --root .—Markdown local links are validbash scripts/validate-runtime-plugins.sh—runtime plugin validation passed(claude plugin validate2 件も Validation passed)grep -rn 'ndf:codex\|ndf:gemini\|skills/codex\|skills/gemini'の残存が履歴文書(issues/、docs/superpowers/plans/)のみであることSKILL.mdが 500 行以内(285 行)release PR: #66