SuperAPI AI 工具集

plan

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:当用户想要一份计划而不是直接执行时使用该技能。本轮只做规划,不实现代码,不修改项目文件(计划 Markdown 除外),不运行会改变状态的终端命令,不提交、推送或执行外部动作;必要时可用只读命令或工具查看仓库与上下文。

主要能力:产出具体、可执行的 Markdown 计划,内容可包含目标、当前上下文与假设、建议方案、分步计划、可能改动的文件、测试与验证、风险与取舍及待解决问题。若任务与代码相关,应写明确切文件路径、可能的测试目标和验证步骤。

使用方式:计划用 write_file 保存到 .hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md,路径相对当前工作目录/后端工作区;若运行时给出指定目标路径则使用该路径,否则自行创建带时间戳的文件名。请求足够清晰时直接写计划;/plan 未附明确指令时从当前对话上下文推断任务;确实描述不足时先简短提问。保存后简要回复计划内容与保存路径。

计划写法:假设实现者不了解代码库,任务拆成 2-5 分钟的小步,每步一个动作(写失败测试、运行确认失败、写最小实现、运行确认通过、提交),遵循 DRY、YAGNI、TDD 与频繁提交。计划头部包含功能名、目标、架构、技术栈;每个任务写明目标、文件(新建/修改/测试的确切路径)、步骤、完整可复制代码、确切命令与预期输出、验证步骤。

适用场景:实现多步功能前、拆分复杂需求、通过子代理委派实现前;功能看似简单、打算自己实现或独自工作时也不应跳过。

限制:本技能不执行实现,不编辑计划以外的项目文件,不运行变更性命令;资料未提供具体收费、平台支持范围或效果保证等信息。