スペックを書くのは、エージェント。仕上げるのは、DotMDで。

チャットがレビューに向かない理由

エージェントはスペックを1分で書きます。それを丁寧に読んで正しく仕上げるのは、いまもあなたの仕事で、チャットはそれに向いていません。段落を引用して希望を書くと、エージェントはファイルの半分を書き直し、何が変わったのかわかりません。次のやり取りも、同じ手探りから始まります。

スペックも、コードと同じようにレビューしましょう。DotMDでは、コメントがその箇所に結びつき、修正はそのコメントのすぐ横のファイル上に現れ、ファイルのすべてのバージョンが残ります。

レビューの流れ

1. エージェントがファイルを送ってくる

   エージェントがスペックを書き、レビュー用にあなたへ送ります。通知が届き、ファイルはサイドバーのNeeds Youに並び、エージェントも待機します。

2. 箇所にコメントする

   表や図、コードも含め、仕上がりどおりにドキュメントを読みます。変更したい箇所を選択し、⌥⌘Mを押して、希望を書きます。何かを送る前に、ファイル全体に目を通しましょう。

3. Sendを押す

   Reviewパネルの下にあるSendをクリックします。エージェントは、それぞれの箇所と行番号つきで、すべてのコメントを一度に受け取ります。

4. 修正がファイルに現れる

   エージェントがファイルを編集し、コメントごとに、何をしたかのメモを添えて返します。古いテキストは赤、新しいテキストは緑で、答えているコメントのすぐ横に表示されます。

5. 承認または再オープンして、最後に承認する

   Acceptで修正を受け入れ、Reopenでより良いメモをつけて戻し、Accept Allでまとめて受け入れます。変更するところがなくなったらApproveをクリックすると、エージェントは作業を続けます。

こうしてレビューするもの

エージェントがMarkdownファイルとして書き、動き出す前に正しくしておきたいものすべてです。

• 機能のスペックと設計ドキュメント。
• エージェントがコードを書く前の実装プラン。
• 手順の抜けが高くつく、移行・ロールアウトのプラン。
• ほかの人が従うREADMEやドキュメント。
• 行ごとに間違いがありうる比較表。

コメントは、エージェントなしでも使えます。下書きへの自分用のメモとして。

見落としは、起きません

待っているエージェントは、つい忘れがちです。DotMDは、作業の邪魔をせずに、それを目に入る場所に置きます。

• サイドバー上部のNeeds Youには、誰かがあなたを待っているファイルがすべて並びます。レビューを待つエージェントや、まだ確認していない修正です。
• Dockのアイコンには、あなたを必要とするファイルの数が表示されます。
• ファイルの上にはバナーが出て、待っている内容をReviewボタンつきで示します。ツールバーのReviewボタンには、確認待ちの修正の数が赤で表示されます。
• エージェントは1回の呼び出しで待機し、あなたが読んでいる間は、どれだけ長くてもトークンを消費しません。

必要なもの

• macOS 14以降のMac。
• レビューとエージェント連携にはDotMD Proが必要です。3日間の無料トライアルつきのYearly、またはLifetimeです。Markdownを読むだけなら無料。料金をご覧ください。
• DotMDにつないだ、MCP対応のエージェント。Claude CodeとCodexのガイドに、それぞれ1行の設定が載っています。

AIスペックのレビューについての質問

その他の質問