关于 autogoal
Autogoal 是用于管理 Agent 工作流中明确提出及长期目标的技能,涵盖目标复用、规划、暂停与恢复、证据跟踪和完成规则。
主要功能
- 01区分明确目标与普通任务
- 02复用现有目标和计划
- 03规定暂停与恢复流程
- 04跟踪义务和证据
- 05设定完成及阻塞规则
适用场景
- 01管理多阶段审计或迁移
- 02暂停并恢复长期工作
- 03跟踪验收证据直至完成
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ udecode/ dotai --skill autogoal安装后在 Claude Code 中输入/autogoal确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdassets/templates/docs.mdgoal-repair.mdgoal.mdmajor-task.mdtask.mdassets/templates/packs/agent-native.mdbrowser.mddocs.mdpackage-api.mdperformance-observability.mdreferences/method.mdplans.mdscripts/check-complete.mjscreate-goal-scratchpad.mjscreate-goal-scratchpad.test.mjscreate-goal-template.mjsinit-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>.mdnode .agents/skills/autogoal/scripts/init-templates.mjs仅在需要显式初始化模板时使用。
项目模板会覆盖共享内置模板。创建过程保留标志、路径和不覆盖行为;它绝不会自动填充无关模板。只选择有用的包。精简计划会保留目标、阈值、验证面、约束、边界、阻塞条件、检查清单、证据、风险和下一步行动。不强制包含门禁/阶段/重启表格或置信度百分比。
对于多负责人工作,请遵循该方法中的合格负责人遍历和人工协助队列。立即推迟有证据的手动前置条件;将不明确的工具/访问诊断限制为两次知情尝试或十分钟,以先到者为准。在延续过程中保留推迟项,并将迭代核算与完整目标完成分开。
遵循仓库的证明和发布负责人。通过的文件检查器只能证明已记录的义务已解决;它无法制造运行时、已部署或外部证明。在将目标标记为完成之前,完成每个必需的验收项,包括关联的子计划和适用的发布义务。
遵循实际的目标工具状态规则。只有在达到必需的重复阻塞阈值且无法取得有用进展后,才标记为阻塞;预算耗尽或困难不是阻塞因素。如果用户恢复一个被阻塞的目标,请应用该工具的最新阻塞审计。不要仅仅为了停止而标记为完成。当有预算的目标完成时,报告最终 token 使用量。
绝不要仅仅因为存在某个目标就写入记忆、发布、给他人发消息或创建周期性自动化。
仅在适用方法章节所对应的情况发生时阅读这些章节:
- 现有目标与请求的目标不同:活动目标冲突。
- 定义新目标或不确定的证明:目标解剖、可衡量结果 和 证据类型。
- 修复损坏的目标状态或计划/辅助脚本契约:修复模式。
- 暂停或恢复:暂停处理 和 恢复协议。
- 多个负责人或手动前置条件:有界批次。
- 创建计划、选择包或解释请求的规划模式/时间限制:计划选择。对于独立子计划,请使用 关联计划树。
- 结束验收或声明重复阻塞:完成规则 和 阻塞规则。
- 研究结果:研究目标。
示例和完整流程仍可在那里获取;例行检查点不需要重新阅读整个参考文档。