Helloloop

HelloLoop for Claude Code

这是 HelloLoop 的 Claude Code 原生技能入口。

默认流程

0. 仅在用户显式调用 /helloloop，或明确要求使用 HelloLoop 时才介入；不要接管普通 Claude 会话
1. 自动识别目标仓库与开发文档
2. 如果用户未明确指定执行引擎，先确认本轮引擎；Claude 只作为推荐项，不自动选中；如果用户明确要求改用 Codex / Gemini，先确认再切换
3. 分析当前代码与文档目标之间的真实进度和偏差
4. 在目标仓库根目录创建或刷新 .helloloop/
5. 输出中文执行确认单
6. 用户确认后，继续用当前确认的执行引擎原生工具接续开发、测试和验收；每个任务完成后都要复核任务是否真正闭合，backlog 清空后还要复核主线目标是否真正闭合，直到最终目标完成

关键规则

• 未显式调用 helloloop 且用户也没有明确要求使用 HelloLoop 时，不允许接管普通 Claude 会话。
• 如果缺少目标仓库或开发文档，必须停下来询问用户。
• 如果当前目录看起来像普通项目目录，默认直接把当前目录当作项目目录；只有明显是工作区或用户主目录时才额外询问项目目录。
• 如果当前项目目录里没有明确开发文档，只补充询问开发文档，不展示内部扫描分类。
• 项目路径对外只有一个概念；如果用户提供的项目路径不存在，直接按新项目路径处理，不要再追问“新项目路径”。
• 如果当前项目与开发文档目标明显冲突，必须先确认是继续现有项目、清理后重建，还是取消。
• 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎。
• 只有识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误等硬阻塞时，才允许结束本轮自动执行。
• 不允许跳过执行确认单直接开始正式开发。
• 不允许把开发文档整体压成一个大任务；需要输出足够细的 backlog。
• 代码是事实源，开发文档是目标源。
• 不允许因为执行引擎一句“已完成”就直接结束；必须经过任务复核和主线终态复核。
• 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用客套套话收尾。
• 遇到失败、阻塞、依赖未满足或风险超出自动阈值时，必须明确说明当前状态。

.helloloop/ 最低要求

• backlog.json
• project.json
• status.json
• STATE.md
• runs/

安全要求

• Windows 上避免使用危险的嵌套命令、拼接删除命令和 cmd 风格破坏性流程。
• 不允许静默失败、静默回退、吞掉错误。
• 真正执行前先确认，真正结束前先验证。