# Hedl：面向AI辅助编程的确定性完成门控工作流

> Hedl是一个为AI辅助编码设计的迭代层，通过确定性完成门控脚本实现本地与CI一致的质量检查，支持对抗性审查和阶段纪律的可选层。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-06-01T21:44:48.000Z
- 最近活动: 2026-06-01T21:50:13.946Z
- 热度: 150.9
- 关键词: AI coding, completion gate, CI/CD, code review, workflow, agent skill, deterministic checks, software quality
- 页面链接: https://www.zingnex.cn/forum/thread/hedl-ai
- Canonical: https://www.zingnex.cn/forum/thread/hedl-ai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：neilgfoster
- 来源平台：github
- 原始标题：hedl
- 原始链接：https://github.com/neilgfoster/hedl
- 来源发布时间/更新时间：2026-06-01T21:44:48Z

## 原作者与来源\n\n- **原作者/维护者**: neilgfoster\n- **来源平台**: GitHub\n- **原始标题**: hedl\n- **原始链接**: https://github.com/neilgfoster/hedl\n- **发布时间**: 2026年6月1日\n\n## 项目概述\n\nHedl是一个为AI辅助编码设计的**迭代层**，专注于解决"任务是否真正完成"这一核心问题。它围绕一个**确定性完成门控**构建：一个脚本在本地运行与CI相同的检查，决定任务是否真正完成。项目采用分层设计，支持可选的对抗性审查和阶段纪律，能够与现有的项目管理工具（如GitHub Issues）集成而非取代它们。\n\n## 核心设计理念\n\n### 确定性门控\n\nHedl的核心创新在于`am_i_done.py`脚本，它实现了：\n\n- **本地与CI一致性**：本地预提交钩子与CI运行相同的检查套件\n- **无推理判决**：脚本本身决定通过或失败，不依赖AI判断\n- **分层检查**：本地运行基础检查（干净工作树、分支命名规范、代码检查、类型检查、测试），CI运行超集检查（增加PR模板有效性、过时工作项ID、未解决的审查线程、Dependabot警报）\n\n这一设计直接借鉴了mcp-cli项目的`am-i-done`概念，但将其打包为纯Python实现，无需JavaScript/Bun工具链。\n\n### 三层采用策略\n\nHedl提供渐进式采用路径：\n\n#### 1. 仅门控层（Gate-only）\n\n最简单的入门方式，只需将`am_i_done.py`放入任意仓库，两分钟即可完成设置。\n\n#### 2. 轻量级层（Lightweight）\n\n在门控基础上增加：\n- 阶段纪律管理\n- 对抗性审查机制\n- 5个核心斜杠命令\n\n#### 3. 团队层（Team）\n\n完整功能集，包括：\n- Claude Code集成\n- 并行工作树门控检查\n- GitHub Issues后端（目前只读，写回功能计划中）\n\n### 隐形模式（Invisible Mode）\n\n这是Hedl的独特功能之一。通过`install.py --invisible <tier>`，你可以在不拥有写入权限的仓库中安装Hedl，所有工件都被git忽略。这样你可以在不影响团队代码库的情况下，使用本地门控和审查面板。当你准备好提议团队采用时，运行`--make-visible`即可。\n\n## 对抗性审查机制\n\nHedl的审查系统包含以下组件：\n\n### 审查调度器\n\n根据差异自动选择最小审查员集合，由确定性调度检查（`am_i_done.py --check dispatch`）支持。\n\n### 命名审查代理\n\n预定义的审查代理角色，每个专注于特定领域：\n- 安全审查员\n- 性能审查员\n- 可维护性审查员\n- API设计审查员\n\n### 可组合提示库\n\n审查提示可以组合和定制，支持不同深度和广度的审查需求。\n\n## 阶段与工作项跟踪\n\nHedl引入`.work/`状态文件来管理工程流程：\n\n- **单任务原则**：每个操作者同一时间只能处理一个工作项\n- **阶段纪律**：任务在明确的阶段（规划、实现、验证、完成）中移动\n- **可追溯性**：完整的工程旅程记录\n\n## 工具无关核心\n\nHedl的设计理念是"工具无关核心，薄适配器"：\n\n- **门控脚本**：纯Python，任何AI编码工具都能使用\n- **状态管理**：JSON/Plain Text格式\n- **工作流文档**：Markdown格式，人类和AI均可阅读\n\n目前提供Claude Code、GitHub Copilot和OpenCode的薄适配器（ADR-038）。\n\n## 采用场景分析\n\n### 不适合使用Hedl的情况\n\n- 小型或一次性项目，仪式成本超过收益\n- 不需要可追溯工程旅程的独立开发者\n- 对原生Claude Code流程满意的用户\n- 希望零Python依赖的项目\n- 需要完整项目管理系统（如Jira、Linear）的场景\n\n### 适合使用Hedl的情况\n\n- 需要确定性"是否完成？"检查的AI生成工作\n- 希望对抗性审查和阶段纪律作为可选层而非强制框架\n- 希望与现有PM工具集成而非替换\n- 需要在不强制团队采用的情况下，在他人仓库中使用个人迭代纪律\n\n## CI/CD集成\n\nHedl提供SHA固定的GitHub Actions工作流：\n\n- **完成门控**：每个PR自动运行\n- **CodeQL分析**：Python和Actions安全扫描\n- **Dependabot**：依赖更新监控\n\n注意：门控在配置分支保护前是**建议性**的——没有正确的CI上下文保护，PR可以在门控失败的情况下被合并。\n\n## 实际意义\n\nHedl代表了一种新的AI辅助开发工作流范式：\n\n1. **质量保证前移**：在提交前捕获问题，减少CI反馈循环\n2. **确定性验证**：消除"应该可以了"的猜测，用脚本给出明确答案\n3. **渐进采用**：从简单门控开始，按需增加复杂度\n4. **团队协作友好**：隐形模式允许个人先试用，再推动团队采用\n\n对于使用AI编码工具的团队，Hedl提供了一个轻量级但严谨的框架，帮助管理AI生成代码的质量和可追溯性。\n\n## 关键收获\n\nHedl项目的核心价值在于将"完成"的定义从主观判断转变为客观检查。通过确定性门控脚本，它确保了本地开发环境与CI之间的一致性，减少了"在我机器上能跑"类问题。同时，其分层设计和隐形模式体现了对开发者实际工作流程的深刻理解——不是强制改变团队习惯，而是提供可选的增强层，让采用者按自己的节奏逐步接受。