haft

让 AI 记住你的技术决策，过期自动提醒，避免反复扯皮

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 103 🐛 待处理 14 👀 关注 15

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1396

维护状态维护中

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队m0n0x41d

官网地址https://haft.tools

GitHubhttps://github.com/m0n0x41d/haft

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议NOASSERTION

主要语言Go

技术栈/模型ai-agents,ai-coding,anthropic,claude,claude-code,codex,context-memory,cursor,cursor-ai,developer-tools,first-principles,gemini-cli,human-ai-collaboration,mcp,reasoning,spec-driven-development,systems-engineering

GitHub 星标★ 1396

上线时间2025-12-10 00:00:00

代码更新2026-09-28

仓库体积362.6 MB

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数6

项目介绍

haft 是一个面向 AI 编程助手的工程决策引擎，核心解决 AI 在长周期开发中做出的技术决策容易过期、被遗忘的问题。它允许开发者将关键决策以结构化框架记录下来，包括问题背景、备选方案、权衡取舍和最终选择，并自动跟踪决策的时效性。当代码变更、依赖升级或上下文变化导致决策依据失效时，haft 会主动提示决策已过期，并支持对多个决策进行一致性校验，防止出现相互矛盾的方案。它集成 Claude Code、Cursor、Gemini CLI、Codex 等主流 AI 编程工具，让 AI 在生成代码时能自动参考历史决策，避免重复讨论或偏离既定方向。项目用 Go 实现，轻量且启动快，适合团队在 AI 辅助开发流程中沉淀工程知识，减少无效返工。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1396

技术标签

ai-agents ai-coding anthropic claude claude-code

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

支持 bash 的 macOS / Linux 环境（安装脚本通过 curl 管道执行）
系统已安装 curl
一个已存在的本地项目目录，用于执行 haft init 初始化
至少一个 AI 编程宿主：Claude Code 或 Codex 为稳定支持，其余为实验性或遗留适配器
已初始化过的项目需安装新二进制后完全重启或重连宿主

安装与启动步骤

1安装 haft

README 提供官方安装脚本，直接通过 curl 下载并管道给 bash 执行，安装 haft 二进制。
```
curl -fsSL https://raw.githubusercontent.com/m0n0x41d/haft/main/install.sh | bash
```
2初始化项目

在项目目录首次使用需初始化一次。裸 haft init 仅在标准终端下弹出交互式多选且不预选宿主；脚本和 CI 必须显式指定宿主。
```
haft init --claude
```
3选择宿主集成

按实际使用的工具选择参数：--codex 写入 MCP+skills+AGENTS.md，--claude 写入 MCP+skills+CLAUDE.md；加 --local 使用仓库内 skills。
```
haft init --codex --local
```
4只要项目核心

如果暂不需要接入任何宿主，可只用 --core-only 初始化项目核心与决策账本，不写入宿主载体。
```
haft init --core-only
```
5重启或重连宿主

安装新二进制后需完全重启或重连编程助手宿主，使其重新加载 MCP 服务与 skills；不要在已初始化项目上重复执行 init。
6Cursor 中启用 MCP

使用 Cursor 时，初始化后打开 Settings -> MCP 找到 haft 并打开开关，Cursor 默认会禁用新增的 MCP server。

关键配置

配置项	必填	说明	示例
`--project-root`	是	手动迁移时指定项目绝对根路径，校验项目绑定	`/absolute/project/root`
`--project-id`	是	手动迁移时指定项目 ID，与 project-root 一起校验绑定	`qnt_........`

如何确认成功

重启宿主后，MCP 列表中出现 haft 服务，且项目内已生成 CLAUDE.md / AGENTS.md 对应段落与 12 个 skills，即初始化成功。

常见问题

Q：裸执行 haft init 报错或卡住怎么办？

A：非交互环境下裸 init 会在写文件前失败，不会猜测宿主。请显式指定宿主参数，如 haft init --claude、haft init --codex 或 haft init --core-only。

Q：Cursor 里初始化了但没生效？

A：Cursor 默认禁用新增 MCP server。打开 Settings -> MCP，找到 haft 并手动打开开关即可。

Q：已初始化过的项目升级后要重新 init 吗？

A：不需要。安装新二进制并完全重启或重连宿主即可；新的 haft serve 会自动应用标记为启动安全的迁移边界，当前覆盖 57 -> 58 和 58 -> 59，重复 init 不是常规数据库维护手段。

Q：启动时提示需要手动迁移边界怎么办？

A：使用该诊断给出的确切回退命令：haft project migrate --project-root /absolute/project/root --project-id qnt_........，不要用通用迁移命令替代其他类型的诊断恢复路径。

注意事项

仅使用官方 install.sh 安装，避免自行编译或改名安装。
Claude Code 与 Codex 是稳定支持的宿主，Grok、Hermes、Zed、Antigravity、Cursor、Gemini CLI、OpenCode 属实验性或遗留适配器。
Grok 使用 haft init --grok，项目内 .grok/config.toml 优先于 Claude/Cursor 兼容 MCP 源，初始化后需在 /mcps 中重载或开新会话。
MCP 的 haft_decision(action="decide") 在存在可验证宿主回执前保持 fail-closed 并返回 operator_confirmation_required。

核心亮点

决策过期检测机制，能感知代码变更和依赖升级，主动提示决策失效
支持多决策一致性校验，防止 AI 生成相互矛盾的方案
深度集成主流 AI 编程工具，包括 Claude Code、Cursor、Gemini CLI 和 Codex，上手成本低

不足之处

项目较新，文档和社区生态仍在建设中，实际使用案例有限
决策记录需要人工维护，对团队流程规范性有要求，否则容易失真

适用场景

团队使用 AI 编程助手进行大型重构，需要锁定技术选型方向
多人协作的 AI 辅助开发项目中，统一决策口径避免冲突
长期维护的项目中，追踪历史决策是否仍适用于当前代码状态

替代项目

Aider、Continue、Cline

上一篇：Everywhere

下一篇：claude-skills