| name | helloloop |
| description | 仅当用户显式调用 `/helloloop`，或明确要求使用 HelloLoop 时，Claude Code 才按开发文档先分析当前进度，再展示确认单，并在确认后持续接续开发。 |
HelloLoop for Claude Code
这是 HelloLoop 的 Claude Code 原生技能入口。
默认流程
- 仅在用户显式调用
/helloloop，或明确要求使用 HelloLoop 时才介入；不要接管普通 Claude 会话
- 自动识别目标仓库与开发文档
- 如果用户未明确指定执行引擎，先确认本轮引擎；
Claude 只作为推荐项，不自动选中；如果用户明确要求改用 Codex / Gemini，先确认再切换
- 分析当前代码与文档目标之间的真实进度和偏差
- 在目标仓库根目录创建或刷新
.helloloop/
- 输出中文执行确认单
- 用户确认后，继续用当前确认的执行引擎原生工具接续开发、测试和验收；每个任务完成后都要复核任务是否真正闭合，backlog 清空后还要复核主线目标是否真正闭合，直到最终目标完成
关键规则
- 未显式调用
helloloop 且用户也没有明确要求使用 HelloLoop 时，不允许接管普通 Claude 会话。
- 如果缺少目标仓库或开发文档，必须停下来询问用户。
- 如果当前目录看起来像普通项目目录，默认直接把当前目录当作项目目录；只有明显是工作区或用户主目录时才额外询问项目目录。
- 如果当前项目目录里没有明确开发文档，只补充询问开发文档，不展示内部扫描分类。
- 项目路径对外只有一个概念；如果用户提供的项目路径不存在，直接按新项目路径处理，不要再追问“新项目路径”。
- 如果当前项目与开发文档目标明显冲突，必须先确认是继续现有项目、清理后重建，还是取消。
- 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎。
- 只有识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误等硬阻塞时，才允许结束本轮自动执行。
- 不允许跳过执行确认单直接开始正式开发。
- 不允许把开发文档整体压成一个大任务；需要输出足够细的 backlog。
- 代码是事实源，开发文档是目标源。
- 不允许因为执行引擎一句“已完成”就直接结束；必须经过任务复核和主线终态复核。
- 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用客套套话收尾。
- 遇到失败、阻塞、依赖未满足或风险超出自动阈值时，必须明确说明当前状态。
.helloloop/ 最低要求
backlog.jsonproject.jsonstatus.jsonSTATE.mdruns/
安全要求
- Windows 上避免使用危险的嵌套命令、拼接删除命令和
cmd 风格破坏性流程。
- 不允许静默失败、静默回退、吞掉错误。
- 真正执行前先确认，真正结束前先验证。
