クラウド版 Claude Code は「指示書を書く仕事」
クラウド版 Claude Code は人間在席なしで何時間も走るので、最初の指示書 (job spec) の質 が結果のすべてを決めます。 雑なプロンプトを投げると、雑な成果物 + 大量の課金が返ってきます。
良い クラウド版 Claude Code 依頼の 5 要素
| 要素 | 何を書く | 例 |
|---|---|---|
| 1. 目的 (Why) | なぜそれが必要か | 「来週の経営会議で競合動向を報告するため」 |
| 2. 入力 (Input) | データの所在・形式 | 「Drive の competitors.csv の 30 社分」 |
| 3. 手順 (How) | 期待する作業フロー | 「各社の料金ページを訪問 → プラン構造を抽出 → 表化」 |
| 4. 出力 (Output) | 成果物の形式・置き場 | 「Markdown 表形式、Drive /competitor-report.md に保存」 |
| 5. 完了の定義 (DoD) | 何が揃えば終わりか | 「30 社全部、空欄なし、典拠 URL 付き」 |
❌ 雑な依頼 (これだとダメ)
wzxhzdk:0
→ クラウド版 Claude Code は何社調べる? どこから取る? どんな形式? いつ終わる? 推測で 8 時間動いて、的外れな成果物が返る可能性大。
✅ 良い依頼 (5 要素揃い)
wzxhzdk:1
完了の定義 (DoD)
- [ ] 30 社すべて表に行がある (N/A 含む)
- [ ] 各行に典拠 URL と取得日がある
- [ ] サマリ 3 行が完成している
- [ ] 注目すべき動き 5 点がある
- [ ] レポートが Drive に保存され、URL を返す
制約
- スクレイピングは 各社サイトの robots.txt を尊重
- 1 社あたり最大 3 ページまで読む (それ以上は深追いしない)
- 推測で数値を入れない (取れなかったら N/A)
- 全工程の所要時間は 4 時間まで。超えそうなら中断して状況報告
連絡
- 完了したら Slack の #marketing-reports に「完了通知 + 主要発見 1 行」
- 途中で詰まったら同チャンネルに状況報告 (「30 社中 18 社まで処理済、ここで何をすべき?」)
wzxhzdk:0
出力: Drive /team-folder/output-YYYY-MM-DD.md
wzxhzdk:1
出力: 新ブランチ cw/<task-id> に commit → PR 作成
PR title: "[クラウド版 Claude Code] React 17→18 migration"
PR body: 何をしたか + 変更ファイル一覧 + テスト結果
wzxhzdk:2
出力: #updates チャンネルに「完了。サマリ: ... 詳細: wzxhzdk:3」
wzxhzdk:3
出力: claude.ai のチャット内で「ダウンロード」リンク表示
wzxhzdk:4
出力: 社内 API POST /api/reports/competitor-pricing に JSON で投稿
wzxhzdk:0
ここまでの進捗ありがとう。robots.txt で取れない 3 社は スキップして、残り 27 社で完了して。
wzxhzdk:1
前回の出力は <理由> で不十分でした。 次は <修正点> を必ず守って再実行してください。 Drive のファイルは上書きせず
-v2.mdでお願い。
wzxhzdk:2
目的
<なぜこのタスクをやるか、ビジネス文脈>
入力
- データ: <所在 / 形式 / 件数>
- 参考: <参照すべき資料・ガイドライン>
- アクセス: <必要な認証・Connector>
手順
- <ステップ 1>
- <ステップ 2>
- <ステップ 3> ...
出力
- 形式: wzxhzdk:6
- 置き場: wzxhzdk:7
- ファイル名: wzxhzdk:8
完了の定義 (DoD)
- [ ] <チェック項目 1>
- [ ] <チェック項目 2>
- [ ] <チェック項目 3>
制約
- 時間: 最大 wzxhzdk:4、超えそうなら中断して報告
- 品質: <推測しない / 出典必須 / etc>
- 倫理: wzxhzdk:5
連絡
- 進捗: <30 分 / 1 時間 ごとに、どこに>
- 完了: <どこに通知>
- 詰まったら: <どう報告> ```
このテンプレを Project Knowledge に入れておくと、毎回コピペするだけで品質の高い依頼が書けます。
次のジョブ仕様を改善してください。問題点と修正案を示し、最後に修正版を全文で示してください。
「競合 SaaS 30 社の料金プランを調べて表にして。Drive に保存して。なるべく早く。」