SuperAPI AI 工具集

plan

通用与其它

查看项目

更新于 10-16 09:51

技能介绍

用途:为中大型任务产出以项目原则为依据的实施计划,计划写入 brain/plans/,本身不实现任何代码,计划即交付物。\n\n主要能力与流程:\nStep 0 复杂度分诊:若仅涉及 1-2 个文件且方案显然,会提示无需计划并建议直接实现;涉及 3 个以上文件、新架构、多方案待选或范围不清时才进入正式规划。\nStep 1 加载原则:读取 brain/principles.md 并跟踪其中的 [[wikilink]] 逐篇阅读,计划概览与阶段文件中按名称引用这些原则。\nStep 2 界定范围与约束:用 AskUserQuestion 明确范围内外、依赖与平台限制,以及完成标准。\nStep 3 上下文探索:通过 Task 工具交给 Explore 子代理并行调查既有代码、约定、依赖、测试与类型,避免在主上下文做大范围探索。\nStep 4 汇总领域技能:匹配已安装技能并发现缺失技能。\nStep 5 编写计划:按模板生成目录结构、概览与阶段文件;阶段粒度建议每阶段 1 个函数/类型加测试或 1 个 bug 修复,单阶段尽量不超过 2-3 个文件,偏好 8-10 个小阶段;涉及既有代码时做从第一性原理的重设计,架构决策在概览约束段列出 2-3 个备选方案及取舍。写完后需更新 brain/plans/index.md 与 brain/todos.md,不改 brain/index.md(由自动索引钩子维护)。已完成计划归档到 brain/archive/plans/。\nStep 5b 自检:概览至少用 [[wikilink]] 引用 2 条 brain 原则;阶段不得超出文件与测试用例上限;阶段文件不得含代码块,只描述类型与函数的意图。\nStep 6 呈现与让出:总结阶段、边界、适用技能与验证方式,请用户审阅;再发出阶段让出事件:\n\nnoodle event emit --session $NOODLE_SESSION_ID stage_yield --payload '{"message": "Plan written to brain/plans/NN-slug-name/overview.md"}'\n\n自主会话模式:在非交互式 Noodle 执行会话(如 Cook、Oops、Repair)中,跳过 Step 2 的提问与 Step 6 的等待,直接写计划、提交并发出 stage_yield 后结束;Step 4 可自行安装技能。全程用 TaskCreate/TaskUpdate/TaskList 跟踪进度。\n\n限制:不实现任何代码;不做大规模主上下文探索;阶段文件禁止写具体代码;官方资料未提供收费、价格或平台支持信息。