SuperAPI AI 工具集

generate

通用与其它

查看项目

更新于 10-15 16:50

技能介绍

用途:这是 prd-taskmaster 流水线的第二阶段(GENERATE),由编排器在 current_phase 为 GENERATE 时调用,用户不直接调用。目标是把 DISCOVER 阶段的发现结果转成规格文档,再解析为任务并展开子任务。

主要能力与流程:先按发现深度选择并加载模板(comprehensive 或 minimal),模板是规范形状,不可自造;随后把模板写入 .taskmaster/docs/prd.md,替换全部占位符并补充项目细节。必须执行 CONSTRAINT CHECK,确认 DISCOVER 的每条约束都出现在规格中;执行 SCOPE CHECK,按规模控制任务数(Solo 8–12、Team 12–20、Enterprise 20–30)。占位符要么替换、要么删除、要么用 reason: 注明延期原因,裸占位符视为校验失败。

校验与解析:用 validate_prd 得到 score、grade、warnings、placeholders_found,等级为 EXCELLENT 91%+、GOOD 83–90%、ACCEPTABLE 75–82%、NEEDS_WORK <75%;裸占位符大于 0 必须先修复。之后计算任务数并解析任务,写入 .taskmaster/tasks/tasks.json,再运行复杂度分析,结果写入 .taskmaster/reports/task-complexity-report.json,需直接读取该 JSON 而非 stdout 表格。最后必须把每个任务展开为子任务,使用 backend op expand(python3 script.py expand),不要用按 id 并行调用,否则会因非原子读改写导致子任务静默丢失;慢速提供方下可等待 5–15 分钟,用 tasks.json 的 mtime 判断存活,并直接读取 tasks.json 校验覆盖率。

限制:进入时 check_gate 返回 gate_passed: false 属预期;重入时若报告违规应停止。证据门要求校验等级 ACCEPTABLE+、裸占位符为 0、任务已解析、复杂度已分析、全部任务有子任务,之后调用 advance_phase 转入 HANDOFF,不直接调用 HANDOFF。资料未提供具体收费、价格与平台信息。