create-prd

PRD の作成

以下のフェーズに沿って、プロダクトのアイデアを完全な PRD ドキュメントにまとめます。PRD の内容はすべて中国語で作成します（中国語を話すチームを対象とします）。

出力モード

$ARGUMENTS に基づいて出力モードを決定します。

引数	モード	出力
--md（デフォルト）	ローカル Markdown	プロジェクトディレクトリに .md ファイルとして保存
--lark	Feishu クラウドドキュメント	Lark のリッチテキスト機能を使って lark-cli で作成

--lark モードでは、任意の保存先引数を指定できます（相互排他）。トークンまたは Feishu の URL に対応します。

• --folder-token — 保存先フォルダー（トークンまたは URL）
• --wiki-node — 保存先 Wiki ノード（トークンまたは URL）
• --wiki-space — 保存先 Wiki スペースのルート（ID または URL、あるいは my_library）

URL はそのまま lark-cli に渡します。トークンを手動で抽出する必要はありません。保存先を指定しない場合は、ユーザーの個人スペースのルートがデフォルトになります。

フェーズ 0：コンテキストの取り込み

既存の設計ドキュメントや要件ドキュメントを確認します。

1. docs/、prd/ ディレクトリ、またはユーザーが指定したファイルを検索します
2. 見つかった場合は、重要な情報（課題の説明、対象ユーザー、主要機能）を抽出し、あらかじめ入力された内容として使用します
3. 何も見つからなかった場合は、このフェーズを省略します

フェーズ 1：PRD の種類を決定

必要な PRD の種類をユーザーに確認します。

• Full（推奨）：標準セクションをすべて含み、複雑な機能に適しています
• Brief：主要なセクションのみを含み、小規模な機能や迅速な反復に適しています
• One-pager：1 ページの概要で、コンセプトの検証や経営層への報告に適しています

フェーズ 2：情報の収集

references/prd-interview-questions.md にある質問に沿って、1 回に 1 問ずつ尋ねます。次の質問に進む前に回答を待ちます。

• 基本情報（7 項目）：すべての種類で必須
• Full 版の追加項目（5 項目）：Full の場合のみ
• AI エージェントの境界：PRD を AI コーディングエージェントが利用する場合に必要

フェーズ 0 であらかじめ入力された内容が見つかった場合は、確認のためにユーザーに提示し、該当する質問は省略します。

フェーズ 3：PRD ドキュメントの生成

1. テンプレートを選択：

   • Full：references/prd-template-full.md
   • Brief：references/prd-template-brief.md
   • One-pager：references/prd-template-onepager.md

2. 内容を記入：収集した情報を各セクションに反映し、references/prd-best-practices.md の執筆原則に従います

3. AI エージェントが利用しやすい内容にする：

   • 各要件を個別に検証可能な項目として記述します（長い段落よりリストを優先）
   • 非目標は肯定的な制約として表現します
   • P0 機能を、テスト可能なチェックポイントを含む 5〜15 分のエージェント作業段階に分割します
   • Full 版には、3 層の境界フレームワーク（自律的に実行／確認が必要／禁止）を含めます

4. 品質要件：

   • 課題の説明を具体的なデータまたは調査結果で裏付けます
   • 目標は SMART 原則に従います
   • 成功指標は定量化します
   • 曖昧な表現（「およそ」「場合によっては」「試す」など）を避けます
   • 能動態と具体的な動詞を使用します

5. 形式：

   • --md モード：見出し階層が明確な標準 Markdown
   • --lark モード：Lark 形式の Markdown（Feishu の拡張機能セクションを参照）

フェーズ 4：検証と保存

references/prd-validation-checklist.md に従って検証します。検証項目は、網羅性、SMART 目標、コンテンツの品質、BDD 受け入れ基準です。

--md モード

検証後にファイルを保存します。

• ファイル名：PRD-[ProductName]-[YYYYMMDD].md
• docs/ または prd/ ディレクトリを優先し、いずれも存在しない場合は現在の作業ディレクトリに保存します
• 保存先とファイルの概要を報告します

--lark Mode

検証後に Feishu ドキュメントを作成します。

1. CRITICAL — スタンドアロンの lark プラグイン（lark@frad-dotclaude）がインストールされていることを確認し、認証にはその lark-shared スキルに従ってください
2. ドキュメント作成のガイダンスには、lark プラグインの lark-doc スキルに従ってください
3. docs +create の全パラメーターと Lark 独自の Markdown 構文については、lark-doc-create.md を参照してください
4. PRD の内容を Lark 独自の Markdown に変換してください（Feishu 拡張機能のセクションを参照）
5. ドキュメントを作成します。

   lark-cli docs +create --title "PRD-[ProductName]-[YYYYMMDD]" \
     [--folder-token TOKEN_OR_URL | --wiki-node TOKEN_OR_URL | --wiki-space ID_OR_URL] \
     --markdown "<lark-flavored-markdown>"
   

6. PRD が長い場合は分割してください。前半には docs +create を使用し、残りのセクションには docs +update --mode append を使用します
7. board_tokens がある場合：
   • lark プラグインの lark-whiteboard スキルに従ってください
   • 各ホワイトボードに実際の内容（フローチャート、アーキテクチャ図）を入力してください
   • タスクを完了する前に、すべてのホワイトボードに実際の内容を入力してください
8. ドキュメントの URL を報告してください

フェーズ 5：次のステップ

保存後、以下のフォローアップの選択肢を提案してください。

• PRD を実装チケットに変換する
• 未解決の質問について設計上の判断を見直す
• レビューとフィードバックのためにチームと共有する

Feishu ドキュメントの拡張機能

CRITICAL — --lark モードでは、Feishu のリッチテキスト機能を活用するため、Lark 独自の Markdown 構文を使用してください。

PRD のセクションごとに必要な Feishu の機能

PRD セクション	Feishu の機能	説明
プロジェクトのメタデータ（バージョン／日付／オーナー）	<lark-table>	ヘッダー行付きの拡張テーブル
主要なリスク／前提条件／依存関係	<callout>	色分け：リスク＝赤、前提条件＝青、依存関係＝黄
主要な目標／成功指標	<callout emoji="..." background-color="light-green">	主要な OKR を強調
優先度の比較（P0／P1／P2）	<grid cols="3">	3 列の横並びレイアウト
ユーザージャーニー／ビジネスプロセス	<whiteboard type="blank">	フローチャート。lark-whiteboard を使って記入
システムアーキテクチャ	<whiteboard type="blank">	アーキテクチャ図。lark-whiteboard を使って記入
マイルストーン／タイムライン	<whiteboard type="blank">	タイムライン図
対象外／スコープからの除外事項	<callout emoji="..." background-color="light-red">	対象外の範囲を赤で強調
用語集／略語	2 列の Markdown テーブル	コンパクトな参照表
意思決定の記録	<callout> + 引用	根拠を添えた主要な決定事項

ホワイトボードのルール

ユーザージャーニー、システムアーキテクチャ、データフロー、マイルストーン、チーム編成にはホワイトボードを挿入してください。テキストのみの内容や、データ量の多い内容（テーブルを使用）には挿入せず、ユーザーがテキストのみを希望している場合も挿入しないでください。

形式の原則

• 見出しレベルは最大 4 つまで
• セクション間には --- 区切りを使用
• タイトルと重複するトップレベルの見出しは書かないでください（Feishu が自動生成します）
• コールアウトは控えめに使用し、太字にするのは主要な用語だけにしてください
• 重要な指標やステータスには <text color="red"> を使用
• Feishu が目次を自動生成するため、手動で追加しないでください

品質の原則

• データに基づく：具体的なデータとユーザー調査で問題提起を裏付けてください
• SMART 目標：具体的、測定可能、達成可能、関連性がある、期限が明確
• 簡潔で明確：冗長さを避け、開発チームがそのまま実装できるほど明確に説明してください
• コラボレーション重視：PRD はコラボレーションツールです。命令ではなく、議論を促すトーンにしてください
• 2 つの対象読者を考慮した設計：人間のチームと AI コーディングエージェントの両方に役立つものにしてください

関連ファイル

• references/prd-interview-questions.md — 情報収集用アンケート
• references/prd-validation-checklist.md — 検証チェックリスト
• references/prd-template-full.md — 完全版テンプレート
• references/prd-template-brief.md — 簡易版テンプレート
• references/prd-template-onepager.md — 1 ページ版テンプレート
• references/prd-best-practices.md — ベストプラクティスガイド
• references/prd-examples.md — 高品質な PRD の例
• スタンドアロンの lark プラグイン（lark@frad-dotclaude）— Lark CLI スキル（--lark モード）