用途:把书面规划文档转换为任务跟踪系统中的工单层级结构,适用 ClickUp、Linear、Jira、Asana、Notion、GitHub Projects 等跟踪器。
主要能力与流程:
- 捕获意图:确认源文档、目标跟踪器、目标容器(列表/项目/看板/仓库)及已完成项状态。导入前先做就绪性检查,要求任务可分离、每个任务有标题或标识、存在层级或分组结构;缺失则停止并说明具体缺口。上下文、验收标准、依赖表达为强烈建议项,缺失时警告并取得操作者明确同意。若无可用的跟踪器集成,可退回生成 markdown 文件作为复选框式工单。
- 一次性询问四个澄清问题:层级深度(3 级 Phase→Task→Steps、2 级 Steps 以 markdown 清单内嵌、扁平加阶段标签)、已完成项处理、依赖处理(原生依赖链接或仅描述)、标签。默认推荐 2 级。
- 构建前估算工单数量与耗时,并建立 ID 映射文件(如 mkdir -p .plan-import && echo "plan_id,tracker_id" > .plan-import/ids.csv),每次创建后立即追加,支持失败与恢复。
- 自顶向下创建层级,暂不接依赖;描述字段使用跟踪器支持的 markdown 字段(如 ClickUp 的 markdown_description),开头放结构化元数据。状态设置建议先创建再单独更新,避免创建调用整体失败。
- 依赖单独批处理:抽取 Blocked by: 边到 .plan-import/deps.csv,用 ids.csv 解析 ID(awk 精确匹配,避免 P1.T1 与 P1.T10 误匹配),并行分批调用;失败记录后重试一次。方向保持一致,通常为子工单 waiting_on 父工单。
- 验证:抽查工单 markdown 渲染、依赖视图、层级嵌套,并统计创建数量。
限制:不适用于非结构化散文、愿景或会议记录;具体跟踪器字段、状态字符串格式等细节需查阅对应参考文件;文档未提供具体收费、价格与效果信息。