haft
为AI编码代理提供基于FPF的工程治理与决策框架
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：haft。 它的用途是：为AI编码代理提供基于FPF的工程治理与决策框架 完整的 Skill 内容见：https://321skill.com/skills/haft/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/h-frame 我们需要一个新的用户认证微服务”，Haft会引导你定义问题域、机器域和需求。然后说“/h-compare”，它会帮你生成并对比JWT、OAuth2等不同方案。最后，你使用“/h-decide”手动记录最终选择及其理由，所有决策和证据都自动存入`.haft/`目录供审计。
介绍
Haft是一个AI辅助软件交付的治理底层框架，旨在解决AI编码代理（如Claude Code、Cursor）快速生成代码时，项目因缺乏规范、定义模糊而难以进行严肃工程治理的问题。它通过创建.haft/工件图，将问题框架、方案比较、决策记录和运行证据转化为可审计的工件，并在内核边界强制执行这些规范。
用户可以通过三种方式使用Haft：在编码代理中使用其技能和斜杠命令（如/h-frame、/h-decare）自动触发工作流；通过CLI（如haft problem、haft decision）手动访问；或通过MCP服务器（haft serve）为任何LLM代理提供程序化访问。其核心是作为工具与使用者之间的“手柄”，将原始模型能力转化为受治理的工程实践。
它特别适合那些已经使用AI编码代理，但希望引入严谨工程纪律的团队或个人，如需要管理复杂项目、确保决策可追溯、或进行高质量系统设计的开发者。Haft v8版本已放弃独立的交互式代理，转而专注于为现有编码代理添加治理层。
使用前需注意，Haft本身不是编码代理或文档生成器，而是治理框架。它要求用户（人类负责人）在AI完成框架分析和方案比较后，亲自做出最终绑定决策。升级v8版本时需参考迁移指南，了解已移除的功能。
核心特点
与单纯提升编码效率的Agent不同，Haft的核心是引入“第一性原理框架（FPF）”作为工程决策的操作系统，强制进行问题框架、方案比较和证据追踪，将AI的快速编码能力约束在可审计、可治理的工程流程内。
注意事项
不适合仅需快速生成代码片段、无需严格工程治理和决策追溯的轻量级或探索性编码任务。
常见问题
Haft和普通的AI编码助手（如Claude Code）有什么区别？
Haft不是编码助手，而是为编码助手添加治理规则的框架。它强制你在写代码前先定义问题、比较方案、记录决策，确保工程过程可审计。
我需要单独运行Haft的Agent吗？
不需要。v8版本已取消独立Agent。Haft现在以技能、CLI和MCP服务器的形式，集成到你正在使用的编码代理（如Cursor、Claude Code）中工作。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/haft/raw/index.md 读取 haft 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/haft/raw/index.md（查看排版版本）