create-output-format

出力形式の作成

workflow-planning-process ワークフロー用の新しい出力形式アダプターをひな形から作成します。各形式アダプターは、関心事ごとに1つずつ、5つのファイルで構成されるディレクトリです。

ステップ 1：情報を収集する

何かを書き始める前に、ツールについて理解します。ユーザーに次の情報を尋ねてください。

1. ツール／システムの名前は何ですか？
2. ドキュメントへのリンク — 公式ドキュメント、API リファレンス、MCP サーバーのドキュメントなど、関連するものすべて

ユーザーがこれらの情報を最初に提供している場合は、そのまま調査に進みます。

調査

提供されたドキュメントを WebFetch を使用してすべて取得し、読みます。ドキュメントから次の点を明らかにします。

• タスクの保存方法（API、データベース、ファイルなど）
• 操作方法（MCP サーバー、REST API、CLI ツール、ファイルシステム）
• タスクの作成、読み取り、更新、検索の方法
• サポートされているタスクのプロパティ — ステータス値、優先度、ラベル／タグ、見積もり
• ブロック関係／依存関係をサポートしているか（プロジェクト内およびプロジェクト間）
• 概念の対応関係 — プロジェクト、フェーズ、タスク、依存関係をそれぞれ何で表すか
• 必要なセットアップや設定
• よりシンプルな方法と比べた利点とトレードオフ
• 制約や制限事項

不明点の確認

調査で分かったことを要約して提示し、ユーザーに確認または訂正を求めます。ドキュメントに記載がない、または曖昧な点（この形式を選んだ理由、複数のインターフェースがある場合の希望、セットアップの詳細など）は、AskUserQuestion を使って確認します。

ツール名に基づく kebab-case の形式キーを提案し、ユーザーに確認します。

ユーザーが理解内容を確認するまで、先に進まないでください。

ステップ 2：インターフェースを理解する

references/contract.md を読みます。ここでは、すべての形式が実装する必要のある5ファイルのインターフェースが定義されています。

ステップ 3：形式のディレクトリを作成する

次の場所にディレクトリを作成します。

skills/workflow-planning-process/references/output-formats/{format-key}/

ステップ 4：ファイルを作成する

ステップ 1 で収集した情報を使って、必須の5ファイルをそれぞれ作成します。構造の参考として、references/scaffolding/ にあるひな形テンプレートを使用します。

テンプレート	作成するファイル
about.md	{format}/about.md
authoring.md	{format}/authoring.md
reading.md	{format}/reading.md
updating.md	{format}/updating.md
graph.md	{format}/graph.md

各ファイルで次の手順を行います。

1. ひな形テンプレートの構造をベースにします
2. 収集した情報に基づく形式固有の内容で、すべての{placeholder}トークンを置き換えます
3. テンプレートのガイダンスコメント（``で始まる行）を削除します
4. 曖昧な説明ではなく、具体的なコマンド、API 呼び出し、または MCP 操作を記載します

ステップ 5：形式を登録する

既存のパターンに従って、skills/workflow-planning-process/references/output-formats.md にエントリーを追加します。

### {Format Name}
format: `{format-key}`

adapter: [{format-key}/](output-formats/{format-key}/)

{One-line description of the format.}

- **Pros**: ...
- **Cons**: ...
- **Best for**: ...

ステップ 6：検証する

次の項目を確認します。

• ディレクトリにファイルがちょうど5つある：about.md、authoring.md、reading.md、updating.md、graph.md
• すべての{placeholder}トークンが置き換えられている
• about.md に構造の対応表が含まれている
• authoring.md にタスクのプロパティ（ステータス、フェーズのグループ化、ラベル。優先度や依存関係は含めない）が記載されている
• authoring.md に完全なタスク作成例が含まれている
• reading.md にステータス、優先度、依存関係、フェーズを使った次のタスクの順序付け方法が説明されている
• updating.md にすべてのステータス遷移とタスクプロパティの変更方法が記載されている
• graph.md に優先度レベルと依存関係の追加／削除方法が記載されている
• 形式が output-formats.md に登録されている