用途:将 Markdown 实施计划或规格说明导入为 Overdo 任务图,在写入前完成校验,避免无效变更。适用于用户要求导入/指定计划文件,或把规格转换为 Overdo 任务的场景。
主要能力:读取目标 Markdown 文件;解析里程碑与编号任务;构建包含阻塞关系(blockers)和校验门(gates)的任务图;在创建任务前验证图结构;验证通过后仅通过 Overdo MCP 写入任务;返回执行交接命令 /overdo-orchestrate ...。
必要用法:先确认当前会话已挂载 Overdo MCP 工具,必须存在 overdo_init、overdo_plan_import、overdo_task_list(或 overdo_task_progress)。若缺失则立即停止,返回 Mutation status: not applied,并提示重启 OpenCode 会话;不得用 shell 命令替代 MCP 写入。调用 overdo_plan_import 时传入 markdownPath 和可选 dbPath,它是规范导入路径,应一次创建完整任务树(任务与阻塞关系)。导入后用 overdo_task_list 或 overdo_task_progress 验证。示例调用:/overdo-plan docs/specs/feature-x/SPEC.md --db .overdo/tasks.db。
校验规则:至少存在一个里程碑任务;每个阻塞引用必须解析到已存在的任务 ID;任务不能阻塞自身;依赖图必须无环;校验门仅限 lint、unit、integration、e2e。
失败行为:校验失败时不通过 MCP 写入任何内容,返回包含失败阻塞/任务 ID 的简明错误列表,并建议使导入有效所需的最小 Markdown 修改。
输出格式:计划来源文件路径;校验通过/失败及具体问题;任务负载预览(任务 ID、标题、阻塞、校验门);变更状态 applied 或 not applied;通过时给出确切的 /overdo-orchestrate ... 命令。
限制:依赖 Overdo MCP 工具可用;不提供替代写入方式;具体安装与配置细节暂未提供。