~loop

Agent Skills › hellowind777/helloagents › ~loop

~loop

GitHub

长任务入口，将链路收敛为goal自动执行加QA验收。适用于多轮持续执行、跨会话恢复及长程AFK任务，确保按方案包推进并由~qa完成最终质量闭环与收尾。

skills/commands/loop/SKILL.md hellowind777/helloagents

Trigger Scenarios

用户发起长程或复杂任务需要跨会话恢复的执行流多轮持续执行的自动化流程

Install

npx skills add hellowind777/helloagents --skill ~loop -g -y

More Options

Non-standard path

npx skills add https://github.com/hellowind777/helloagents/tree/main/skills/commands/loop -g -y

Use without installing

npx skills use hellowind777/helloagents@~loop

指定 Agent (Claude Code)

npx skills add hellowind777/helloagents --skill ~loop -a claude-code -g -y

安装 repo 全部 skill

npx skills add hellowind777/helloagents --all -g -y

预览 repo 内 skill

npx skills add hellowind777/helloagents --list

SKILL.md

Frontmatter

{
    "name": "~loop",
    "policy": {
        "allow_implicit_invocation": false
    },
    "description": "长任务入口 — 在 Codex 中优先走 `\/goal -> ~auto -> ~qa`，把长程续跑交给 `\/goal`，把执行推进交给 `~auto`，把最终质量闭环交给 `~qa`（~loop 命令）"
}

Trigger: ~loop <目标描述>

~loop 不再维护独立的指标实验循环。它是长任务入口，默认把链路收敛为：

/goal -> ~auto -> ~qa

其中：

/goal 负责长程续跑、恢复与预算
~auto 负责按方案包持续推进 AFK 任务
~qa 负责最终审查、验证命令、阻断修复、回归验证与收尾证据

适用边界

适合：多轮持续执行、跨会话恢复、较长的 AFK 任务
不适合：普通小任务、单轮可完成任务、单纯质量审查；这些优先直接走 ~auto 或 ~qa
真正的指标实验、benchmark 对赌、keep/revert 试验，不再由 ~loop 承担

流程

0. 当前工作流优先

若当前上下文中已注入“当前工作流约束”或“当前推荐下一命令”，先服从它
~loop 不是绕过方案包和质量契约的越级入口；它只是把长任务执行链路固定为 /goal -> ~auto -> ~qa

1. 先落稳方案包

优先复用当前活跃方案包
若当前没有足够可信的方案包，而任务又属于长任务、跨模块任务或高风险任务，先补 ~plan 或 ~prd
tasks.md 必须能支撑长程执行：任务按顺序拆好，标注 AFK / HITL，写清依赖、涉及文件、完成标准和验证方式
contract.json 必须至少落成 qaMode 与 qaFocus

2. Codex + goals 已启用时

把 ~loop 视为 Codex 的长任务入口，优先直接进入 /goal
/goal 不直接消费原始需求文档；只消费当前方案包里的 “Codex /goal 执行入口”
/goal 入口必须明确以下约束：
- 默认主执行命令是 ~auto
- 按 tasks.md 顺序完成所有可执行 AFK 任务
- HITL 只在缺少用户决策、凭据、人工验收或其他真实阻塞时暂停
- 不得把单轮结果、阶段总结或“下一步建议”当成完成
- 全部 AFK 任务完成后，必须进入 ~qa
- 只有 ~qa 通过、当前会话证据写全、HelloAGENTS 收尾完成后，才允许标记 goal complete
若当前已经运行在 Codex active goal 下，继续沿当前 goal 执行，不重复创建新 goal

3. 非 Codex 或 goals 不可用时

明确当前无法使用 Codex 原生 /goal
仍按同一意图执行长任务，但只走 ~auto -> ~qa
这种情况只是无 /goal 的降级路径，不把它包装成等价的 goal 能力

4. 执行期间的状态维护

~loop 必须维护 state_path
“主线目标”写当前长任务目标
“正在做什么”写当前 AFK 任务或当前收尾阶段
“下一步”写下一条具体可执行动作，必要时带文件路径
若当前运行在 Codex active goal 下，state_path 仍只负责本地恢复，不替代 goal 自身状态

5. 禁止事项

不再创建基线指标、results log、keep/revert 实验提交或守卫命令循环
不把 /goal 当作质量验收器；最终质量闭环始终由 ~qa 负责
仍有可执行 AFK 任务时，不进入 complete
没有最新 qa-review.json、需要的 advisor.json / visual.json / closeout.json 时，不得报告完成