# Helloloop

> 仅当用户显式调用 `/helloloop`，或明确要求使用 HelloLoop 时，Claude Code 才按开发文档先分析当前进度，再展示确认单，并在确认后持续接续开发。

- Skill: `hellowind777/helloloop-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hellowind777/helloloop-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hellowind777/helloloop-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hellowind777 (https://skillmd.com/u/hellowind777)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hellowind777/helloloop-2

---


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