mcpField
A
autogoal

autogoal

github.com/udecodeAgent 工作流1.2k116 次安装今天更新
代码仓库

关于 autogoal

Autogoal 是用于管理 Agent 工作流中明确提出及长期目标的技能,涵盖目标复用、规划、暂停与恢复、证据跟踪和完成规则。

主要功能

  1. 01区分明确目标与普通任务
  2. 02复用现有目标和计划
  3. 03规定暂停与恢复流程
  4. 04跟踪义务和证据
  5. 05设定完成及阻塞规则

适用场景

  1. 01管理多阶段审计或迁移
  2. 02暂停并恢复长期工作
  3. 03跟踪验收证据直至完成

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/udecode/dotai --skill autogoal

安装后在 Claude Code 中输入/autogoal确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
assets/templates/
docs.md
goal-repair.md
goal.md
major-task.md
task.md
assets/templates/packs/
agent-native.md
browser.md
docs.md
package-api.md
performance-observability.md
references/
method.md
plans.md
scripts/
check-complete.mjs
create-goal-scratchpad.mjs
create-goal-scratchpad.test.mjs
create-goal-template.mjs
init-templates.mjs

详细介绍

Autogoal

仅当用户明确请求目标时(无论是直接请求,还是通过适用于当前请求的长期指令提出),才使用原生目标工具。无需再次询问,也无需单独调用技能,即可执行该指令。若没有此类请求,普通任务、计划、审计或可衡量的成果本身并不授权使用 create_goal。

长期请求

项目或当前对话可能记录了用户的请求:默认使用 Autogoal 处理长期工作。请遵循该请求的确切范围。长期工作是指包含多个执行、调查或验证检查点,并有验收台账的重大目标,例如大型审计、多项差距的实施、迁移或持续调查。这不包括每个问题、小型编辑、耗时的命令或有时间限制的任务。无需自行设定分钟数或 token 阈值。

当该长期请求适用时,请在开展深入工作前启动或复用目标。如果最初规模较小的工作后来扩大到此范围,则届时开始执行该请求。用户明确表示“不要设定目标”等类似要求时,以此为准。保持只读、仅规划、人工分配和发布边界不变;目标的完成门槛应止于用户实际要求的成果。解释或编辑技能不等于调用该技能,但相关工作可能独立符合长期请求的范围。

暂停与恢复

用户直接要求“暂停”“停止”或“暂缓”时,立即将现有计划标记为 Status: Paused,记录用户指令,保留未完成的义务和已保存的下一步,并让当前下一项操作等待用户明确恢复。请在执行用户要求的转做事项(例如修复技能或任务历史记录)之前完成此操作。口头确认或私下记录不算暂停计划。

只有在当前约定允许时,才使用受支持的原生暂停控制,并验证操作结果。如果没有可用的控制,则在同一计划中记录此限制,并告知用户一次;不要声称原生目标已暂停,不要伪造完成或阻塞状态,也不要修改内部目标存储。随后立即结束本轮。切勿创建休眠/轮询循环、重复提醒,或另设目标来管理暂停。

自动继续或恢复时,请先检查计划的暂停状态,再决定要处理的工作。调度器生成的继续指令不等于用户直接恢复。暂停的工作应保持停止状态;明确请求的修复可在其自身范围内继续。只有收到用户的直接指令后才能恢复;恢复时更新现有计划,并重新验证已保存的下一步。参见暂停处理。

单一目标与计划

长期工作必须在执行、中断和上下文压缩期间保留适用要求。每项义务只记录一次,并在现有计划或关联的规范台账中注明其来源、证据和未解决状态。引用详细条目,不要复制它们。对于多个成果,请使用有界批次与证据复用:验收条目不构成独立的执行周期。仅在相关决策适用时加载方法;存在参考资料并不会产生额外义务。在任务接收、重要检查点、恢复和收尾时,遵循检查清单保留。短期工作应直接核对要求,无需创建新目标或计划。

创建目标前先读取现有目标。复用其当前计划和目标;绝不要创建相互竞争的生命周期状态。只有在用户明确要求时才设定 token 预算。在一份计划中记录实际成果、范围、完成门槛、证据和实际阻碍。 文件辅助脚本同样可用于普通计划;它们的历史名称不会创建原生目标:

  • node .agents/skills/autogoal/scripts/create-goal-scratchpad.mjs --template task --title "<title>" [--with <pack>] [--ticket <id>]
  • node .agents/skills/autogoal/scripts/create-goal-template.mjs --skill <name> --from <template>
  • node .agents/skills/autogoal/scripts/check-complete.mjs docs/plans/<plan>.md
  • node .agents/skills/autogoal/scripts/init-templates.mjs 仅在需要显式初始化模板时使用。

项目模板会覆盖共享内置模板。创建过程保留标志、路径和不覆盖行为;它绝不会自动填充无关模板。只选择有用的包。精简计划会保留目标、阈值、验证面、约束、边界、阻塞条件、检查清单、证据、风险和下一步行动。不强制包含门禁/阶段/重启表格或置信度百分比。

对于多负责人工作,请遵循该方法中的合格负责人遍历和人工协助队列。立即推迟有证据的手动前置条件;将不明确的工具/访问诊断限制为两次知情尝试或十分钟,以先到者为准。在延续过程中保留推迟项,并将迭代核算与完整目标完成分开。

遵循仓库的证明和发布负责人。通过的文件检查器只能证明已记录的义务已解决;它无法制造运行时、已部署或外部证明。在将目标标记为完成之前,完成每个必需的验收项,包括关联的子计划和适用的发布义务。

遵循实际的目标工具状态规则。只有在达到必需的重复阻塞阈值且无法取得有用进展后,才标记为阻塞;预算耗尽或困难不是阻塞因素。如果用户恢复一个被阻塞的目标,请应用该工具的最新阻塞审计。不要仅仅为了停止而标记为完成。当有预算的目标完成时,报告最终 token 使用量。

绝不要仅仅因为存在某个目标就写入记忆、发布、给他人发消息或创建周期性自动化。

仅在适用方法章节所对应的情况发生时阅读这些章节:

示例和完整流程仍可在那里获取;例行检查点不需要重新阅读整个参考文档。

评论

支持 Markdown