用途:将架构或设计文档拆解为结构化 JSON 任务图,供自主智能体按依赖顺序执行。输出为 DAG,每个任务自包含、可独立验证,无需访问完整架构文档。
主要能力:从文档中提取全部实现任务,生成含 id、title、description、dependencies、files、acceptance_criteria、verification_steps、context_files、estimated_complexity、implementation_details 的 JSON。任务按 T001、T002 顺序编号,依赖须引用列表内有效 ID,不得跳过或合并任务。
使用方式:开始前先运行 dark-factory list --job $JOB --status pending --include-content 查看已有待办任务;派发后台探索智能体审查文档各节相关文件,了解现有模式、类型与集成点;对不熟悉的库、框架或工具进行网络检索。随后将有效 JSON 写入指定输出路径。
任务规模:每个任务约 1-3 小时人工开发工作量,代码量低于 500 LOC(样板或生成代码除外),超出则拆分。依赖应尽量并行,仅在任务确实无法开始或验收标准无法验证时才添加依赖,避免不必要的串行链。
字段要点:acceptance_criteria 需枚举所有需自动化测试的用例(含文档未提及的边界情况),无法自动化时描述可执行的验证步骤;verification_steps 给出具体命令,如 bun test、cargo build、bun run typecheck;implementation_details 应像向未见过代码库的资深开发者交代,内联架构文档中的模式、函数签名、类型定义、集成点、边界情况与错误处理,按复杂度控制篇幅(低约 50-100 词,中约 100-200 词,高约 200-400 词),并用 ### 标题分段。
限制:写入后必须读回并校验为符合 schema 的有效 JSON,解析失败需修复重写,未通过校验不得结束。资料未提供具体收费、平台支持范围及更多使用限制。