マークダウンドキュメントをタスクに変換する

コマンド実行

すべてのコマンドに dex を直接使用します:

dex <command>

dex が PATH にない場合は、代わりに npx @zeeg/dex <command> を使用してください。開始時に一度確認します:

command -v dex &>/dev/null && echo "use: dex" || echo "use: npx @zeeg/dex"

/dex-plan を使用して、マークダウン計画ドキュメントを追跡可能なdexタスクに変換します。

使用する場合

• 計画モードで計画を完成させた後
• 仕様書を追跡可能なタスクに変換する場合
• 設計書を実装タスクに変換する場合
• ロードマップやマイルストーンドキュメントからタスクを作成する場合
• マークダウン計画または設計コンテンツを追跡する場合

サポートされているドキュメント

計画または設計コンテンツを含むマークダウンファイル:

• 計画モードの計画ファイル (~/.claude/plans/*.md)
• 仕様書 (SPEC.md, REQUIREMENTS.md)
• 設計書 (DESIGN.md, ARCHITECTURE.md)
• ロードマップおよびマイルストーンドキュメント (ROADMAP.md)
• 機能提案およびテクニカルRFC

使用方法

/dex-plan <markdown-file-path>

例

計画モードから:

/dex-plan /home/user/.claude/plans/moonlit-brewing-lynx.md

仕様書から:

/dex-plan @SPEC.md

設計書から:

/dex-plan docs/AUTHENTICATION_DESIGN.md

ロードマップから:

/dex-plan ROADMAP.md

動作内容

1. マークダウンファイルを読み込む
2. 最初の # 見出しからタイトルを抽出 (フォールバックはファイル名)
3. 「Plan: 」プレフィックスを削除 (大文字小文字を問わず)
4. マークダウンコンテンツ全体をコンテキストとしてdexタスクを作成
5. 計画構造を分析して潜在的なサブタスク分割を検討
6. 必要に応じて自動的にサブタスクを作成
7. タスクIDと分割サマリーを返す

例

計画モードファイルから:

# Plan: Add JWT Authentication

## Summary

...

→ タスク説明: 「Add JWT Authentication」(注: 「Plan: 」プレフィックスは削除されます)

仕様書から:

# User Authentication Specification

## Requirements

...

→ タスク説明: 「User Authentication Specification」

自動サブタスク分割

メインタスクを作成した後、スキルは計画構造を分析して、サブタスクへの分割が価値を追加するかどうかを判断します。

階層レベル

スキルは最大3レベルをサポートします (dexによって最大深度が強制されます):

レベル	名前	例
L0	Epic	「ユーザー認証システムを追加」
L1	Task	「JWTミドルウェアを実装」
L2	Subtask	「トークン検証関数を追加」

分割が発生する場合

スキルは以下を含む計画でサブタスクを作成します:

• 3～7個の明確に分離可能な作業項目 (番号付きステップ、異なるセクション、実装フェーズ)
• 複数のファイルまたはコンポーネント間での実装 (異なるモジュール、レイヤー、またはエリア)
• 明確な順序依存関係 (ステップ1の前にステップ2)
• 独立した項目で個別追跡の利益がある

エピックレベルの分割 (サブタスクではなくタスクを作成) される場合:

• 計画に独自のサブアイテムを含む主要フェーズ/セクションがある
• 5個以上の異なる作業エリア
• 計画が複数のシステムまたはコンポーネントにまたがる
• 複数のセッションを要する作業

分割が発生しない場合

スキルは以下の場合に単一タスクを保持します:

• 計画が1つの統一されたタスクを説明 (複数の段落で詳細でも)
• 1～2個のステップのみ (分割に値しない)
• 作業項目が密接に結合 (意味的に分離できない)
• 計画が探索的または調査的 (研究、分析、発見)
• 分割が自然な作業単位を反映しない人工的な境界を作成する

各サブタスクの内容

分割が発生した場合、各サブタスクは以下を含みます:

• 説明: リストアイテム、見出し、またはセクションから抽出された簡潔なサマリー
• コンテキスト: そのセクションの関連詳細と親タスクへの参照
• 親リンク: --parent 経由でメインタスクに自動リンク

例: 分割あり

入力計画 (auth-plan.md):

# Plan: Add Authentication System

## Implementation

1. Create database schema for users/tokens
2. Implement auth controller with endpoints
3. Add JWT middleware for route protection
4. Build frontend login/register forms
5. Add integration tests

出力:

Created task abc123 from plan

Analyzed plan structure: Found 5 distinct implementation steps
Created 5 subtasks:
- abc124: Create database schema for users/tokens
- abc125: Implement auth controller with endpoints
- abc126: Add JWT middleware for route protection
- abc127: Build frontend login/register forms
- abc128: Add integration tests

View full structure: dex show abc123

例: 分割なし

入力計画 (bugfix-plan.md):

# Plan: Fix Login Validation Bug

## Problem

Login fails when username has spaces

## Solution

Update validation regex in auth.ts line 42 to allow spaces

出力:

Created task xyz789 from plan

Plan describes a cohesive single task. No subtask breakdown needed.

View task: dex show xyz789

例: エピックレベル分割 (2レベル階層)

入力計画 (full-auth-plan.md):

# Plan: Complete User Authentication System

## Phase 1: Backend Infrastructure

1. Create database schema for users and sessions
2. Implement password hashing with bcrypt
3. Add JWT token generation and validation

## Phase 2: API Endpoints

1. POST /auth/register - User registration
2. POST /auth/login - User login
3. POST /auth/logout - Session invalidation
4. POST /auth/reset-password - Password reset flow

## Phase 3: Frontend Integration

1. Login/register forms with validation
2. Protected route components
3. Session persistence with refresh tokens

出力:

Created epic abc123 from plan

Analyzed plan structure: Found 3 major phases with sub-items
Created as epic with 3 tasks:
- def456: Backend Infrastructure (3 subtasks)
- ghi789: API Endpoints (4 subtasks)
- jkl012: Frontend Integration (3 subtasks)

View full structure: dex list abc123

オプション

/dex-plan <file> --priority 2              # 優先度を設定
/dex-plan <file> --parent abc123           # サブタスクとして作成

作成後

作成後は、以下のことができます:

• タスクを表示: dex show <task-id>
• 追加サブタスクを作成: dex create "..." --parent <task-id> --description "..."
• 実装を通じて進度を追跡
• タスクを完了: dex complete <task-id> --result "..."

dex show <task-id> を実行して、自動作成されたサブタスクを含む完全なタスク構造を確認します。

使用しない場合

• ドキュメントが不完全または探索的 (ドラフトメモのみ)
• コンテンツが実装可能または準備完了でない
• ファイルがまだディスクに保存されていない
• ファイルに意味のある計画/設計コンテンツが含まれていない

---

スキルの実装手順

これらの手順は /dex-plan を実行するスキルエージェント向けです。 このワークフローに従います:

ステップ1: メインタスクを作成

提供されたマークダウンファイルで dex plan コマンドを実行します:

dex plan <markdown-file> [options]

これは親タスクを作成してそのIDを返します。このIDを後続ステップのためにキャプチャします。

ステップ2: 計画を読み込んで分析

メインタスク作成後、それを読み返して構造を分析します:

dex show <task-id>

分割の可能性について、コンテキストフィールド (完全なマークダウンを含む) を検査します。

ステップ3: 分割判定ロジックを適用

計画構造を分析して判定: これはサブタスクに分割すべきですか?

これらの分割インジケータを探します:

1. 番号付きまたは箇条書きの実装リスト (3～7項目):

   ## Implementation
   
   1. Create database schema → SUBTASK
   2. Build API endpoints → SUBTASK
   3. Add frontend components → SUBTASK
   

2. 実装/タスク/ステップ下の明確なサブセクション:

   ### 1. Backend Changes
   
   - Modify server.ts
   - Add authentication
     → SUBTASK: 「Backend Changes」このコンテキスト付き
   
   ### 2. Frontend Updates
   
   - Update login form
   - Add error handling
     → SUBTASK: 「Frontend Updates」このコンテキスト付き
   

3. ファイル固有のセクション:

   ### `src/auth.ts` - Add JWT validation
   
   [Details about changes]
   → SUBTASK: 「Add JWT validation to auth.ts」
   
   ### `src/middleware.ts` - Create auth middleware
   
   [Details about changes]
   → SUBTASK: 「Create auth middleware」
   

4. 順序フェーズ:

   ## Implementation Sequence
   
   **Phase 1: Database Layer**
   [Details] → SUBTASK
   
   **Phase 2: API Layer**
   [Details] → SUBTASK
   
   **Phase 3: Frontend Layer**
   [Details] → SUBTASK
   

分割しない場合:

• ステップ/項目が1～2個のみ
• 計画が単一の統一された修正または小さな変更
• コンテンツが探索的 (「investigate」「research」「explore」)
• 作業項目が分離不可能 (密接に結合された実装)
• 分割が人工的な境界を作成
• 計画が非常に短い (意味のあるコンテンツが10行未満)

ステップ4: サブタスクを抽出 (分割する場合)

識別された各サブタスクについて:

1. 説明を抽出: リストアイテムテキスト、見出し、またはセクションタイトルを使用

   • 番号付けと箇条書きを削除: 「1. Add auth」→「Add auth」
   • 簡潔に保つ (1～10語)
   • 命令形を使用: 「Add」「Create」「Update」「Fix」

2. コンテキストを抽出: そのセクションの関連詳細を含める

   • そのサブタスクの完全なセクションコンテンツをコピー
   • 参照を追加: 「これは[親タスク説明]の一部です」
   • コードスニペット、ファイルパス、特定の要件を含める

3. サブタスクを作成:

   dex create "<subtask-description>" \
     --parent <parent-task-id> \
     --description "<extracted-context-with-parent-reference>"
   

ステップ5: 結果をレポート

サブタスクが作成された場合:

Created task <id> from plan

Analyzed plan structure: Found <N> distinct implementation steps
Created <N> subtasks:
- <subtask-id-1>: <description-1>
- <subtask-id-2>: <description-2>
- <subtask-id-3>: <description-3>
...

View full structure: dex show <parent-id>

分割が発生しなかった場合:

Created task <id> from plan

Plan describes a cohesive single task. No subtask breakdown needed.

View task: dex show <id>

サブタスク抽出の例

例1: 番号付きリスト

## Implementation Steps

1. Create User model with email, password fields
2. Add POST /api/auth/register endpoint
3. Implement JWT token generation

抽出されたサブタスク:

dex create "Create User model with email, password fields" \
  --parent abc123 \
  --description "Create a User model with email and password fields. This is part of 'Add Authentication System'."

dex create "Add POST /api/auth/register endpoint" \
  --parent abc123 \
  --description "Add POST /api/auth/register endpoint to handle user registration. This is part of 'Add Authentication System'."

dex create "Implement JWT token generation" \
  --parent abc123 \
  --description "Implement JWT token generation for authenticated sessions. This is part of 'Add Authentication System'."

例2: 詳細を含むサブセクション

### Frontend: Login Form Component

Create a new React component at `src/components/LoginForm.tsx`:

- Email and password inputs
- Submit button with loading state
- Error message display
- Validation on submit

### Backend: Auth Routes

Add to `src/routes/auth.ts`:

- POST /login endpoint
- Password verification using bcrypt
- JWT token generation on success

抽出されたサブタスク:

dex create "Frontend: Login Form Component" \
  --parent abc123 \
  --description "Create a new React component at src/components/LoginForm.tsx with email/password inputs, submit button with loading state, error message display, and validation on submit. This is part of 'Add Authentication System'."

dex create "Backend: Auth Routes" \
  --parent abc123 \
  --description "Add to src/routes/auth.ts: POST /login endpoint, password verification using bcrypt, JWT token generation on success. This is part of 'Add Authentication System'."

例3: 分割しない場合

# Plan: Fix Typo in Error Message

## Problem

Error message says 'Sucessful' instead of 'Successful'

## Solution

Fix typo in src/messages.ts line 42

判定: 単一の統一されたタスク、1つの変更のみ。サブタスクを作成しない。

主要原則

1. エージェント判断は重要: 分割が価値を追加するかどうかを判定するために知能を使用
2. 分割しない側に傾ける: 明確に役に立つ場合のみ分割
3. 各サブタスクは意味のあるもの: 単なる1行の変更ではない
4. コンテキストは不可欠: 各サブタスクは独立して実行可能なのに十分なコンテキストを持つべき
5. 計画セマンティクスを保持: 計画の意図と一致しない構造を強制しない