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` 风格破坏性流程。 - 不允许静默失败、静默回退、吞掉错误。 - 真正执行前先确认，真正结束前先验证。