用途
dex-plan 用于将 Markdown 规划文档转换为 dex 中可跟踪的任务。它适用于计划模式产出的计划文件、规格说明文档（SPEC.md、REQUIREMENTS.md）、设计文档（DESIGN.md、ARCHITECTURE.md）、路线图与里程碑文档（ROADMAP.md）、功能提案和技术 RFC 等任何包含规划或设计内容的 Markdown 文件。
主要能力
- 读取 Markdown 文件，从第一个一级标题提取标题；若不存在则使用文件名作为回退。
- 若标题带有“Plan: ”前缀（不区分大小写），自动去除。
- 创建 dex 任务，并将完整 Markdown 内容作为任务上下文。
- 分析计划结构，判断是否适合拆分为子任务，并在合适时自动创建子任务。
- 返回任务 ID 和拆分摘要。
- 支持最多三级层级（dex 强制最大深度）：L0 Epic、L1 Task、L2 Subtask。
使用方式
命令调用：直接使用 dex 执行所有命令：
dex <command>
如果 dex 不在 PATH 中，改用 npx @zeeg/dex <command>。可在开始时检查一次：
command -v dex &>/dev/null && echo "use: dex" || echo "use: npx @zeeg/dex"
使用 /dex-plan 将任意 Markdown 规划文档转换为可跟踪的 dex 任务：
/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
选项：
/dex-plan <file> --priority 2 # 设置优先级 /dex-plan <file> --parent abc123 # 创建为子任务
执行流程（技能代理按此工作流执行）：
- 创建主任务：执行 dex plan <markdown-file> [options]，捕获返回的任务 ID。
- 读取并分析计划：执行 dex show <task-id>，检查 context 字段（包含完整 Markdown）以判断拆分潜力。
- 应用拆分决策逻辑：分析计划结构，决定是否拆分为子任务。
- 提取子任务（若需拆分）：为每个识别出的子任务提取描述（使用列表项文本、标题或章节标题，去除编号和项目符号，保持简洁 1-10 词，使用祈使形式如“Add”“Create”“Update”“Fix”），提取上下文（包含该章节的相关细节，复制完整章节内容，添加引用“This is part of [parent task description]”，包含代码片段、文件路径、具体需求），然后创建子任务：
dex create "<subtask-description>"
--parent <parent-task-id>
--description "<extracted-context-with-parent-reference>"
- 报告结果：若创建了子任务，输出任务 ID、分析结果、子任务列表和查看命令；若未拆分，说明计划为单一内聚任务。
创建后操作：
- 查看任务：dex show <task-id>
- 创建额外子任务：dex create "..." --parent <task-id> --description "..."
- 跟踪实现进度
- 完成任务：dex complete <task-id> --result "..."
拆分决策逻辑
当计划具有以下特征时创建子任务：
- 3-7 个清晰可分离的工作项（编号步骤、不同章节、实现阶段）。
- 跨多个文件或组件实现（不同模块、层或区域）。
- 清晰的顺序依赖（步骤 1 在步骤 2 之前）。
- 独立项，适合单独跟踪。
当计划具有以下特征时创建 Epic 级拆分（创建任务而非子任务）：
- 计划有主要阶段/章节，且各自带有子项。
- 5 个以上不同工作领域。
- 计划跨多个系统或组件。
- 工作需要多个会话。
当计划具有以下特征时不拆分：
- 计划描述一个内聚任务（即使详细且包含多段）。
- 仅 1-2 个步骤（不足以拆分）。
- 工作项紧密耦合（无法有意义地分离）。
- 计划为探索性或调查性（研究、分析、发现）。
- 拆分会产生不反映自然工作单元的人为边界。
- 计划非常短（少于 10 行有意义内容）。
适用场景
- 在计划模式完成计划后。
- 将规格说明文档转换为可跟踪任务。
- 将设计文档转换为实现任务。
- 从路线图或里程碑文档创建任务。
- 跟踪任何 Markdown 规划或设计内容。
限制
- 不适用于：文档不完整或属于探索性（仅为草稿笔记）；内容不可操作或未准备好实现；文件尚未保存到磁盘；文件不包含有意义的规划/设计内容。
- 层级深度最多三级，由 dex 强制。
- 拆分依赖代理判断，原则是“宁可少拆分”，仅在明确有帮助时拆分；每个子任务必须有意义，不能只是单行更改；每个子任务需有足够上下文以独立执行；需保留计划语义，不强行套用不符合计划意图的结构。