SuperAPI AI 工具集

goal-loop-builder

智能体与模型

查看项目

更新于 10-16 01:33

技能介绍

用途:为长周期智能体循环生成可运行契约,输出一份可直接复制的命令,必要时附带持久化的 Markdown 文件。用于编写、改进或审查 Codex /goal 提示、Claude Code /goal 及 /loop 相关契约。默认中文优先,并附英文兼容镜像,除非用户另行要求。

运行方式选择:一次性回答、小改写或简单 shell 输出用普通提示;有单一完成线且需持续推进直到证据证明完成时用 Codex /goal 或 Claude /goal;需定时执行、轮询外部状态、盯 PR/部署或周期性报告时用 Claude /loop;想为裸 /loop 定义默认提示时用 .claude/loop.md,它只定义一个默认提示而非任务列表;/goal 契约用 goal.md 或 <task-slug>.goal.md,Markdown 文件是唯一事实来源,命令只指向它。

仅询问高影响的缺失细节,如运行方式、目标结果、验证面、写入边界、生产访问、凭证或破坏性权限不明;否则采用保守默认并简要说明。

契约要素:结果须为一个具体产物而非活动;验证需为命令、日志、截图、API 响应、生成文件、PR 状态等证据;约束须写明行为、公共 API、数据、风格、安全和分支规则;边界须写明允许写入路径、禁止路径、工具、环境和外部系统;迭代策略为小步、重跑检查、重试前先看日志、反复失败后更换证据来源;停止/暂停须有证明完成的证据与需人工决策的阻塞条件。

/goal 需先写出真实 Markdown 文件,安全时用 goal.md,已存在则用 <task-slug>.goal.md;无项目工作区写入可用输出目录或当前工作区。命令保持一行且少于 350 字符,用 @/绝对路径/file.md 引用文件,不要把完整契约粘进命令。

输出顺序:推荐运行方式、已生成的 Markdown 文件、可复制命令、文件内容摘要、默认选择理由、可选调整、英文兼容镜像。选择运行方式时读 references/runtime-playbook.md;起草命令或 Markdown 时读 references/output-templates.md;保存的 goal 或 loop 产物在称其就绪前运行 python3 scripts/lint_goal_loop.py <file>。

质量要求:拒绝或修正含 [goal]、<path>、TODO、待补充等占位符;验证含糊如“确保能用”;允许“随便改”这类宽泛写入;缺少停止条件、暂停条件、写入边界或验证证据;把完整 /goal 契约直接写进命令;/goal 命令超 350 字符;把 /loop 当作完成驱动命令(/loop 是定时驱动,/goal 才是完成驱动);把 .claude/loop.md 当成多个定时任务。

限制:资料未提供具体安装方式、价格、平台支持范围或效果保证。