SuperAPI AI 工具集

code-task-generator

编程与开发

查看项目

更新于 10-16 01:15

技能介绍

用途:将粗略的功能描述或 PDD 实施计划转换为结构化的 .code-task.md 代码任务文件,供后续实现使用。

主要能力:自动检测输入模式(description 或 pdd);解析 PDD 计划的步骤与清单状态;从描述中识别核心功能、技术需求、复杂度(Low/Medium/High)与技术领域;按 Given-When-Then 生成可度量的验收标准;PDD 模式逐步骤处理,便于步骤间学习;支持在生成后配置 Ralph 自主实现。

使用方式:参数包括 input(必填,可为直接文本、文件路径、目录路径或 URL)、step_number(可选,仅 PDD,指定处理步骤,省略时自动确定下一个未完成步骤)、output_dir(可选,默认 specs/{task_name}/tasks/)、task_name(可选,仅描述模式,覆盖自动生成的任务名)。生成前必须先向用户展示任务拆解方案并获得明确批准,才能创建文件。PDD 模式创建 step{NN}/ 文件夹,任务文件按 task-01-{title}.code-task.md 顺序命名。文件必须包含 YAML frontmatter(status: pending、created、started: null、completed: null),使用 kebab-case 命名与 .code-task.md 扩展名,验收标准需覆盖主功能与单元测试。集成命令:ralph run --config presets/pdd-to-code-assist.yml 或 ralph run -c ralph.yml -H builtin:code-assist。

适用场景:从产品设计文档计划或简单功能描述出发,生成可交由 code-assist 或 Ralph 执行的任务清单。

限制:任务文件必须获得用户批准后才生成;测试要求整合进各任务验收标准,不单独创建测试任务;PDD 模式始终引用设计文档路径,仅纳入直接相关的研究文档;缺失的技术细节会做出合理假设并标注需用户决策处;资料未提供具体定价、支持平台与效果数据。