davidahmann/fde-guide
Key takeaway: FDE Guide 是由 davidahmann 创建的一个面向 Forward Deployed Engineers (FDEs) 和内部应用 AI 团队的技术框架与工程套件。其核心目标是将模糊的操作性问题转化为受支持、可测量且持续运行的 AI 服务。该指南采用三层深度架构：指南层面向领导者、学习者和架构师，提供思维模型、原则和能力路线图；手册层面向一线 FDE，包含生命周期操作手册和人类可读库；工程套件层面向工程师和运维，提供 JSON Schema 模板和可执行参考系统。整个方法建立在“价值工程”哲学之上，强调以被接受的结果为产品，代币仅是输入，自主性仅为设计选择，并通过 12 Factors of AI Value Engineering 将价值契约工程化。仓库采用“Validation-as-Code”设计，内置 Node.js 测试套件，不仅校验代码正确性，还强制治理完整性，如确保每个发布清单关联有效的评估报告。核心工件包括 catalog.json 作为受治理工件注册表，llms.txt 作为文件索引，AGENTS.md 定义 AI 代理修改仓库的规则。环境要求 Node.js ≥ 22，通过 npm ci 和 npm test 验证本地环境。该仓库为 AI 部署工程师提供了一套从原则到自动化验证的端到端实践方法。
- FDE Guide 是一个专为 Forward Deployed Engineers 和内部应用 AI 团队设计的技术框架和工程套件，旨在将模糊的操作问题转化为可度量的 AI 服务。
- 指南采用三层深度架构，分别面向领导者、实践者和工程师，提供从思维模型到 JSON Schema 模板和可执行参考系统的分层内容。
- 核心哲学为价值工程，要求先工程化价值契约再选择架构，并通过 12 Factors of AI Value Engineering 进行形式化。
- 仓库实现“Validation-as-Code”，通过 Node.js 测试套件强制治理完整性，例如验证每个发布清单对应的评估报告。
- 关键工件包括 catalog.json 工件注册表、llms.txt 文件索引、AGENTS.md 代理规则，环境需 Node.js ≥ 22。
- 该指南将全生命周期操作手册和机器可读合约整合在同一仓库中，为前线 AI 部署提供了端到端的工程基准。
对于正在构建或优化前线 AI 部署工程能力的团队而言，davidahmann 的 FDE Guide 提供了一套珍贵且成体系的方法论。它不空谈原则，而是将价值工程、操作契约和验证即代码整合到一个可执行的仓库中。三层架构兼顾了领导者的战略视野、一线工程师的实操手册以及自动化系统的治理需求，让模糊的 AI 需求可以一步步落地为可度量、可审计的生产服务。尤其值得一提的是其 Validation-as-Code 设计，把治理要求写进测试套件，极大地降低了“发布即翻车”的风险。无论你是初次搭建 FDE 团队，还是希望将现有流程标准化，这份指南都值得放入技术工具箱。
FDE Guide 是一个专为 Forward Deployed Engineers 和内部应用 AI 团队设计的技术框架和工程套件，旨在将模糊的操作问题转化为可度量的 AI 服务。
—— 络石智能编辑部 · Editor's Pickdavidahmann/fde-guide
概述
FDE 指南是一个技术框架和工程工具包，专为前线部署工程师（FDEs）和内部应用AI团队设计。其目的是将模糊的操作问题转化为支持良好、可衡量且可运营的AI驱动服务。
该仓库以单一方法构建，提供三个深度层次，使从业者能够根据其具体角色和技术需求来使用素材。
三层架构
| 层级 | 目标受众 | 主要工件 | | --- | --- | --- | | 指南（Guide） | 领导者、学习者、架构师 | 心智模型、原则和能力路线图 guide/README.md 21 | | 手册（Handbook） | 从业者、FDEs | 生命周期剧本和人类可读库 README.md 22 | | 工程工具包（Engineering Kit） | 工程师、运维人员 | JSON Schema 模板和可执行参考系统 README.md 23 |
核心理念：价值工程
该指南基于以下原则运作：被接受的结果是产品，而 token 仅仅是输入，自主权是一种设计选择。它要求在选定架构之前先进行价值合同工程，这一点通过 AI 价值工程的12个要素（12 Factors of AI Value Engineering）得以形式化。
下图将高层交付阶段映射到用于治理这些阶段的具体机器可读合同（schema）和模板。
交付循环到代码实体映射
仓库导航与工具
该仓库是“作为代码的验证”（Validation-as-Code）。它包含一个 Node.js 测试套件，不仅强制执行代码正确性，还强制执行治理完整性，例如确保每个发布清单都指向一个有效的评估报告。
- 入口点：使用 llms.txt 1-20 获取核心文件的完整索引，或使用 catalog.json 1-10 获取受治理工件的注册表。
- 机器合同：AGENTS.md 1-10 定义了AI智能体修改此仓库的规则。
- 设置：需要 Node.js ≥ 22。使用
npm ci后跟npm test来验证本地环境。
系统架构与验证流程
主要章节与子页面
入门与仓库导航
涵盖仓库定位、catalog.json 工件注册表以及技术设置。深入解释三层架构。
- 关键文件：
README.md、catalog.json、AGENTS.md、llms.txt。
FDE 角色与能力路线图
定义 FDE 角色在探索、产品、工程和运营中的职责。提供用于团队发展的能力领域和实践任务。
- 关键文件：guide/capability-roadmap.md 1-50 guide/README.md 11-23
更改日志与版本历史
记录指南的演变，包括向价值工程的转变以及行动边界（Action Boundaries）的引入。
- 关键文件：CHANGELOG.md 1-75
Tags
Related Topics
Expert Comment
This article is curated by the editorial team from public sources for reference only.