效率与协作 markdown-planningplan-modeworkflowfile-writes

计划模式(Plan Mode)

在 .hermes/plans/ 下生成 Markdown 计划,不执行任何代码或变更。

FollowSkills 评估 · FSRS-2.0
不推荐
46/ 100 五分制 2.3 / 5
1 2 3 4 5 6
1信任安全12 / 25 · 2.4/5

技能明确限制为只读操作:不执行代码、不修改项目文件、不运行变更性终端命令,交付物仅限计划文件,权限最小化且符合安全原则。但依赖用户前提(『当用户想要计划而非执行时』),确认机制依赖对话上下文推断,未提供显式的用户确认步骤,且未说明敏感数据处理或回滚机制,故扣分。

2可靠稳定8 / 20 · 2.0/5

指令清晰,提供具体的保存路径格式和文件名生成规则,但未包含错误处理或失败反馈说明,如路径不可写或写入失败时的行为。依赖运行时提供具体路径或自行创建,未明确超出范围时的处理方式。静态阅读未见测试覆盖,故按锚点最高给10分以下。

3适用触发9 / 15 · 3.0/5

适用场景明确(计划模式),并给出了边界(不执行、只写计划文件),触发条件为对话上下文推断。但未提供具体的非适用场景或输入输出示例,环境适配(如中文支持、网络可达性提及)不足,故低于满分。

4规范维护8 / 15 · 2.7/5

文件结构清晰,包含元数据(版本、作者、许可证)、使用说明和保存位置,但未提供安装依赖、变更日志、已知限制或维护责任说明,版本号存在但无变更历史,故按锚点7-15分区间给8分。

5有效结果7 / 15 · 2.3/5

静态评估,无法验证实际执行效果。技能定义的目标(生成可操作的计划)合理,能直接交付计划文件,但未见输出示例或验证用例,边际价值未量化,按静态锚点最高7分为合理。

6证据核验2 / 10 · 1.0/5

无测试、CI或可复现证据,仅有源文件定义。作者声明或仓库README提供一些架构说明,但未覆盖本技能关键路径,按静态阅读锚点最高5分,实际因无验证证据给2分。

证据充分度: 评估于 2026年8月7日 审查版本 0d3389e6f373
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 技能依赖对话上下文的推断,可能误触发为执行模式,需明确用户确认步骤。
  • 未提供错误处理或失败反馈,写入失败时可能静默失败,需要补充。
  • 静态评估无法确认演示效果,实际使用前建议在受控环境测试。
评估证据 [1][2][3][4][5][6][7]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

该技能将代理切换为“计划模式”,仅输出一份可操作的 Markdown 计划,保存到当前工作区的 .hermes/plans/ 目录。它禁止实施、编辑项目文件(计划文件除外)和运行变更命令,只允许只读检查。计划包含目标、当前背景、方法、分步步骤、可能修改的文件、测试、风险等。若无明确请求,则从对话上下文推断任务,或提出澄清问题。保存后,代理简要回复计划内容和路径。

将代理限制为只规划,不执行。它会使用 write_file 工具将 Markdown 计划写入 .hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md(相对于活动工作区)。允许只读命令并检查仓库。根据提示、对话上下文或必要时提出澄清问题来推断要规划的任务。最终提供计划文件和简短回复。

  1. 开发者在实施前想要一份结构化的变更计划,但需要避免意外代码改动。
  2. 项目经理需要在无实际变更的情况下,对功能或重构进行清晰、分步的步骤文件。
  3. 用户希望将需求转化为文件中的可执行计划,以进行审查或与他人共享。
  4. 代理在继续执行前需要一份清晰的路线图,以降低风险和意外修改。

这个 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/ 下。之后您会收到计划内容和保存的路径。示例提示:'请规划添加登录功能,包含步骤和风险。' 代理会生成计划文件。

常见问题

该技能会修改我的项目文件吗?
不会,除非是将计划写入 .hermes/plans/ 目录。它明确禁止编辑其他文件和运行变更命令。
保存计划需要什么权限?
需要文件系统写入权限,用于在当前工作区创建 .hermes/plans/ 目录和文件。需要只读权限来检查仓库内容。
我可以自定义计划保存位置吗?
如果运行时提供了特定的目标路径,则使用该路径;否则使用默认的 .hermes/plans/ 路径。
如果任务不清楚会发生什么?
该技能会要求用户进行澄清,而不是猜测。

同仓库的其他 Skills

均来自 Alpha-Dojo/DojoAgents

相关 Skills