计划模式(Plan Mode)
在 .hermes/plans/ 下生成 Markdown 计划,不执行任何代码或变更。
技能明确限制为只读操作:不执行代码、不修改项目文件、不运行变更性终端命令,交付物仅限计划文件,权限最小化且符合安全原则。但依赖用户前提(『当用户想要计划而非执行时』),确认机制依赖对话上下文推断,未提供显式的用户确认步骤,且未说明敏感数据处理或回滚机制,故扣分。
指令清晰,提供具体的保存路径格式和文件名生成规则,但未包含错误处理或失败反馈说明,如路径不可写或写入失败时的行为。依赖运行时提供具体路径或自行创建,未明确超出范围时的处理方式。静态阅读未见测试覆盖,故按锚点最高给10分以下。
适用场景明确(计划模式),并给出了边界(不执行、只写计划文件),触发条件为对话上下文推断。但未提供具体的非适用场景或输入输出示例,环境适配(如中文支持、网络可达性提及)不足,故低于满分。
文件结构清晰,包含元数据(版本、作者、许可证)、使用说明和保存位置,但未提供安装依赖、变更日志、已知限制或维护责任说明,版本号存在但无变更历史,故按锚点7-15分区间给8分。
静态评估,无法验证实际执行效果。技能定义的目标(生成可操作的计划)合理,能直接交付计划文件,但未见输出示例或验证用例,边际价值未量化,按静态锚点最高7分为合理。
无测试、CI或可复现证据,仅有源文件定义。作者声明或仓库README提供一些架构说明,但未覆盖本技能关键路径,按静态阅读锚点最高5分,实际因无验证证据给2分。
- 技能依赖对话上下文的推断,可能误触发为执行模式,需明确用户确认步骤。
- 未提供错误处理或失败反馈,写入失败时可能静默失败,需要补充。
- 静态评估无法确认演示效果,实际使用前建议在受控环境测试。
这个 Skill 能做什么,适合哪些场景?
该技能将代理切换为“计划模式”,仅输出一份可操作的 Markdown 计划,保存到当前工作区的 .hermes/plans/ 目录。它禁止实施、编辑项目文件(计划文件除外)和运行变更命令,只允许只读检查。计划包含目标、当前背景、方法、分步步骤、可能修改的文件、测试、风险等。若无明确请求,则从对话上下文推断任务,或提出澄清问题。保存后,代理简要回复计划内容和路径。
将代理限制为只规划,不执行。它会使用 write_file 工具将 Markdown 计划写入 .hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md(相对于活动工作区)。允许只读命令并检查仓库。根据提示、对话上下文或必要时提出澄清问题来推断要规划的任务。最终提供计划文件和简短回复。
- 开发者在实施前想要一份结构化的变更计划,但需要避免意外代码改动。
- 项目经理需要在无实际变更的情况下,对功能或重构进行清晰、分步的步骤文件。
- 用户希望将需求转化为文件中的可执行计划,以进行审查或与他人共享。
- 代理在继续执行前需要一份清晰的路线图,以降低风险和意外修改。
这个 Skill 有哪些优点和局限?
- 强制采用无执行、仅规划的工作流,防止意外更改。
- 生成结构化、可操作的计划,包含明确的步骤和风险。
- 适用于各种领域,从代码到任何文件型任务。
- 文件写入使用后端感知的相对路径,可在多种后端工作。
- 计划保存到 .hermes/plans/ 而非 .dojo/plans/,与描述存在差异。
- 未提供测试或验证说明。
- 计划采用较旧的时间戳格式(YYYY-MM-DD_HHMMSS),可能不符合现代标准。
- 未提供内置验证或检查生成的计划。
如何安装这个 Skill?
这是一个名为“计划模式”的 Agent Skill,位于仓库 dojoagents/skills/built_in/plan/ 目录。安装需要将该 SKILL.md 文件夹放置到您的 Agent Skills 目录中(例如 ~/.claude/skills)。整个集合通过 pip 安装:uv pip install dojoagents,但该技能的具体安装未另外记录。请参阅仓库 README 中的安装说明。
如何使用这个 Skill?
在对话中触发计划模式(例如使用 /plan 命令)。然后代理会编写一份 Markdown 计划,并保存到 .hermes/plans/ 下。之后您会收到计划内容和保存的路径。示例提示:'请规划添加登录功能,包含步骤和风险。' 代理会生成计划文件。