tk3.biz
ブログ一覧に戻る

[Released] dev-orchestra: 設計の前のインタビューと、レビューの手間を減らす機能を追加 v1.4.0

はじめに

dev-orchestra は、1 文の依頼から設計・実装・テスト・複数の AI によるレビュー・修正までを回す、Claude Code / Codex / Antigravity のプラグインです。

この記事では、v1.4.0(2026-11-19)の変更をまとめます。v1.3.2 の変更は前回のリリース記事に書いています。今回は、設計の前の質問をインタビューにする機能と、レビューの回を軽くする変更がまとまって入った版です。以下の内容と数字は CHANGELOG によるもので、手元で動かして確かめたのは grill と、新しいコマンドやオプションがあることだけです。

dev-orchestra は GitHub で公開しています(MIT ライセンス)。役に立ちそうと思ったら、スターを付けてもらえるとうれしいです。

→ github.com/istb16/dev-orchestra

主な変更

設計の前にインタビューする(grill)

design.ask_questions に grill という値が増えました。設計の前の質問を、1 通に 1 問ずつ聞きます。答えがあいまいなとき、前の答えと食い違うとき、条件を足したときは、1 つの質問につき 2 問まで追加の質問をします。自分の質問は、意図や成功の基準、範囲の外のことなどの観点から、大事な順に 5 問まで。追加の質問も含めて 10 問聞いたら、続けるかを聞きます。

dev-orchestra config set design.ask_questions grill

実際に試すと、質問は 1 問ずつ全部で 8 問になり、条件を足した答えには追加の質問が来ました。一方で、あいまいな答えは掘り下げずに解釈して進み、資料にある「意図」の観点は聞かれませんでした。試したのは 1 回だけなので、「今回はそうだった」という結果です。手順と出力は、同じ日に出した連載の 25 本目「dev-orchestra に、設計の前にインタビューさせてみた」にまとめています。

決めたことを、レビュアーに伝える

コードレビューの依頼の最後に、「Decisions already made」の節が付くようになりました。中身は 3 つあります。設計の前の質問へのユーザーの答え、計画の Risks と Decisions の節、そして同じレビューの前の回で却下した指摘です。

前の 2 つは前提として扱うよう伝え、コードがそれと食い違うときや、それ自体がおかしいときは、引用して指摘させます。却下した指摘は「前の回の判断」として渡すだけで、Critical や High の問題を見逃す理由にはなりません。ユーザーが決めたことや、一度却下したことを、レビュアーが毎回蒸し返すのを減らすための変更です。節は 1 人あたり 6,000 文字までで、足りないときは却下した指摘から削り、削ったことを書き添えます。

元からあった軽い問題は、仕分けから外す

レビュアーは、今回の変更より前からあって、変更で悪くなっていない問題に Category: pre-existing を付けられるようになりました。Medium と Low のものは P1、P2 … と番号が付き、consolidated.md の「Pre-existing, not triaged」の欄に並びます。指摘の一覧や件数、修正の指示、ループの判断には入らないので、それしかない回は「指摘なし」で終わります。

Critical と High、それに review.blocking_severities に入っている重さのものは、元からあっても今までどおり仕分けます。変更で悪化した問題や、変更で表に出た問題は、ふつうの指摘のままです。

再レビューは、関係する人だけで回す

修正だけを見る再レビューの回は、レビュアーを絞って回すようになりました。残るのは、general の席、relevance: always の席、relevance: security を付けていないセキュリティの席、そして、まだ閉じていない採用済みの指摘を出した席です。relevance: security を付けたセキュリティの席は、修正で触ったパスがセキュリティの判定に当たったときだけ加わります。それ以外の席は、その回は休みます。高リスクのパスに触れたとき、--high-risk や --only を付けたとき、最後に変更全体を見る回は、いつもの人数で回ります。止めたいときは optimization.narrow_re_reviews: false にします。

軽い段を、CLI が自分で選ぶ

役に light の段があるとき、run implementer と run review_fixer は --tier を付けなくても、条件がそろえば自分で light を選ぶようになりました。実装役は、計画で触るファイルが 3 つ以下で、高リスクのパスが無いとき。修正役は、採用した指摘がすべて Medium 以下で、高リスクのパスが無いときです。迷う要素があるときや、同じ工程の直前の light の実行が失敗したときは、役のモデルで走ります。選んだ段と理由は note: の行に出て、status と optimization report にも残ります。1 回だけ役のモデルで走らせるなら --no-auto-tier、止めるなら optimization.auto_tier: false です。

新しいセッションで続ける

summary の最後に、Resume: の行が付くようになりました。

Resume:  in a new session, continue workflow 91433992a718: pass --workflow 91433992a718 to every command (or set DEV_ORCHESTRA_WORKFLOW=91433992a718)

スキルは、ワークフローの切れ目ごとに新しいセッションで続けることを勧めます。1 つのセッションで続けると、オーケストレーターのコンテキストが、ワークフローをまたいで大きくなり続けるためです。

仕分け用の短い表示

review show --brief で、指摘を 1 行ずつ(問題の 1 行目を 140 文字まで)に縮めて表示できるようになりました。根拠や直し方は出ません。review show F3 F5 のように番号を付けると、その指摘だけを全文で出します。スキルの仕分けも、この短い表示から始めます。

細かな変更と不具合の修正

  • jobs wait の既定の待ち時間を、progress.wait_seconds(30〜570 秒)で決められるようになった
  • jobs wait の途中でジョブが「止まっているかもしれない」状態になったら、待ち時間を残していても、すぐに戻る(終了コード 4)
  • Claude Code のようにバイトコードのキャッシュを切って動かす環境でも、キャッシュを使うようにした。status などの起動が約 0.3 秒速くなる
  • 実装役と修正役は、テストを全部ではなく、変更に関係するものだけ走らせる。全部はテストの工程で 1 回走る。全部走らせたいプロジェクトは instructions.implementer などに書く
  • Antigravity(agy)1.5.7 以降で、許可を省く設定を切っていても、シェルのコマンドが走ってしまっていた。今は、許可を省く設定を入れないかぎり断られる

安定化のための対応

新しい機能のテストを足し、仕分けや再レビューの判定の抜けを直すなど、動作を安定させるための対応を行いました。

更新方法

更新のしかたは、使っている CLI ごとに違います。アップデートの方法の手順で、新しい版のタグ(v1.4.0)を指定して更新してください。更新したら、dev-orchestra doctor を一度実行しておくと安心です。

まとめ

  • 設計の前に 1 問ずつ聞くインタビュー(design.ask_questions: grill)が入った
  • レビューでは、決めたことをレビュアーに伝え、元からあった軽い問題を仕分けから外し、再レビューを関係する人だけで回す
  • 軽い段の自動選択、新しいセッションでの続き、仕分け用の短い表示が入った

GitHub: istb16/dev-orchestra(スターを付けてもらえると励みになります)

関連記事