内容
<!--
AI索引和搜索引擎的元数据
- 主题:FDE 顾问协议技能,用于AI智能体
- 架构:软件应用 + 课程(教育)
- 关键词:FDE, 前向部署工程,MCP,智能体技能,AI方法论, FDE Assurance Score, DeepSCR, Palantir FDE, Claude Code, Cursor, Windsurf, Codex
-->
# FDE 顾问协议
> **前向部署工程(FDE)方法论,用于AI编码智能体。**
> 生产级方法论和工具,将Claude Code、Cursor、Windsurf、Codex CLI和OpenClaw转化为前向部署工程师。
[](https://github.com/selectess/fde-consultants-protocoles/actions/workflows/ci.yml) [](skill/tests/) [](https://selectess.github.io/fde-consultants-protocoles/)
[](SKILL_TRUST_SCORE.json)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://python.org)
[](#distribution)
---
## 什么是FDE顾问协议?
**FDE顾问协议**是一种工业级技能,教导任何AI编码智能体应用**前向部署工程**方法论,该方法论由Palantir、OpenAI企业、Anthropic应用AI和100多家A轮融资的AI初创公司使用。
2026年,FDE职位增长了**729%**([来源](https://www.tryexponent.com/blog/what-is-a-forward-deployed-engineer))。该技能将工作流程编码为:
- 一种可重用的方法论,包含**14个操作原则**、**10个反模式**和**6-Q分解**
- 一个**4阶段循环**(范围确定 → 原型开发 → 生产 → 反馈)
- **7个MCP工具**,通过stdio传输暴露
- 一个多智能体运行时环境(**Modex**),具有4个协调角色
- 一个**FDE Assurance Score注册表**,具有SHA-256链(可由任何人使用`shasum`验证)
## 适用对象
- 希望在每个智能体输出上获得可验证的FDE Assurance Score徽章的**AI实验室**
- 需要智能体工作标准接收表单的**企业工程团队**
- 需要在编码前进行范围确定的**独立工程师和顾问**
- 探索假设驱动的智能体工作流程(DeepSCR协议)的**研究人员**
## 快速入门(60秒)
### 选项1 — 零安装(任何网络LLM)
将[`skill/ZERO-INSTALL.md`](skill/ZERO-INSTALL.md)复制粘贴到ChatGPT、Claude.ai或Gemini中。立即生效,无需安装。
### 选项2 — 一键安装(CLI智能体)
```bash
git clone https://github.com/selectess/fde-consultants-protocoles.git
cd fde-consultants-protocoles
bash install.sh
```
自动安装到Claude Code、Codex CLI、Hermes和OpenClaw。Cursor和Windsurf使用附带的单文件规则(参见`skills/`)。
### 选项3 — 手动安装
参见[`skill/INSTALL.md`](skill/INSTALL.md),在任何运行时环境中进行逐步设置。
### 选项4 — 从捆绑包恢复
如果您克隆了仓库,但只获得了几个文件,请参见[`RESTORE_FROM_BUNDLE.md`](RESTORE_FROM_BUNDLE.md)。
---
## 包含内容
### 1. 方法论(`skill/SKILL.md`,Apache-2.0)
核心交付成果。编码:
- **14个操作原则**(例如,*编码前范围确定*,*评估前声称准确性*,*无自我认证*)
- **10个反模式**(例如,*"只是使用AI/ML"*,*相信我兄弟*,*神奇数字默认值*)
- **6-Q分解**(过程 → 决策 → 数据 → 成本 → 当前状态 → 成功指标)
- **4阶段循环**(范围确定 → 原型开发 → 生产 → 反馈)
- **FDE Assurance Score章节**,在每个交付成果中均需

### 2. MCP服务器(`skill/mcp_server/`,Apache-2.0)
7个通过stdio传输暴露的工具,**零外部依赖**(仅限Python标准库):
- `fde_decompose` — 验证6-Q分解,拒绝模糊输入
- `fde_roi` — 计算ROI,失败则拒绝
- `fde_scientific_search` — 保留推广门控(DeepSCR)
- `fde_evals` — 生成评估标准 + 黄金标准
- `fde_ontology` — 从案例研究中构建领域本体
- `fde_trust_score` — 计算FDE Assurance Score

### 3. Modex多智能体运行时环境(`modex/`,MIT)
1个智能体本地运行时环境(免费,MIT)+ 插件,ed25519许可证(6美元生命周期,BSL)。
4个协调角色:
- **领导** — 将问题分解为6-Q规格
- **研究员** — 收集科学 + 市场证据
- **构建者** — 生成交付成果(代码,规格,交接)
- **认证者** — 独立重新推导FDE Assurance Score

### 4. FDE Assurance Score注册表(`registry/`,Apache-2.0)
公开,只允许追加,SHA-256链。每个认证的交付成果都有一个条目:
- `genesis.json` — 链起源
- 3个案例研究(SaaS流失率93/100,零售预测91/100,金融科技欺诈93/100)
- 每个条目通过`prev_hash`链接到前一个(git支持,无SaaS)
### 5. 独立认证者(`modex/certify_skill.py`)
从原始证据中重新推导技能的FDE Assurance Score。需要打破自我认证循环(操作原则#14:*绝不自我认证*)。
---
## FDE Assurance Score(此技能)
| 组件 | 最大值 | 实际值 |
|---|---|---|
| 声称(可证伪) | 25 | **25** |
| 矛盾(已知限制) | 25 | **24** |
| 证据链(文件:行 + SHA-256) | 30 | **29** |
| 反模式(无流行词汇,无假网址) | 20 | **18** |
| **总计** | **100** | **94/100 → 已认证** ✅ |
技能**自我认证94/100**。独立认证者(`modex/certify_skill.py`)**重新推导100/100**。
验证自己:
```bash
python3 -m pytest skill/tests/ modex/tests/ mcp-server/tests/test_thin_skill.py
# 期望:116通过,约5秒
python3 -m modex.certify_skill --skill-path ./skill --output ./cert.json
# 期望:FDE Assurance Score 100/100,认证通过
```
---
## 架构(3层)
| 层 | 组件 | 描述 |
|---|---|---|
| **第1层 — 接口** | Claude Code, Cursor, Windsurf, Codex CLI, OpenClaw, ChatGPT, Gemini | 人机交互处 |
| **第2层 — MCP服务器** | 7个工具,通过stdio传输 | `fde_*`工具 |
| **第3层 — 核心逻辑** | SKILL.md + 脚本 + 模板 + 参考 + 示例 + 案例研究 | FDE方法论本身 |

---
## 分发(多平台)
该技能在每个主要AI编码智能体上都适用:
| 平台 | 状态 | 安装方法 |
|---|---|---|
| **Claude Code** | ✅ 原生 | `/plugin marketplace add` 或符号链接到 `~/.claude/skills/` |
| **Claude.ai** | ✅ 原生 | 在聊天中粘贴 `skill/ZERO-INSTALL.md` |
| **Cursor** | ✅ 原生 | 项目规则(`.cursor/rules/fde-consultant.mdc`) |
| **Windsurf** | ✅ 原生 | 项目规则(`.windsurf/rules/fde-consultant.mdc`) |
| **Codex CLI** | ✅ 原生 | 放入 `~/.codex/skills/` |
| **OpenClaw** | ✅ 原生 | 放入 `~/.config/agents/skills/` |
| **Kiro** | ✅ 原生 | 放入 `.kiro/skills/` |
| **Hermes** | ✅ 原生 | `bash hermes/install.sh` |
| **ChatGPT** | ✅ 零安装 | 粘贴 `skill/ZERO-INSTALL.md` |
| **Gemini** | ✅ 零安装 | 粘贴 `skill/ZERO-INSTALL.md` |
| **Continue.dev** | ⚠️ 手动 | 作为 `~/.continue/prompts/` |
| **VS Code Copilot** | ⚠️ 手动 | 作为存储库说明 |
---
## 仓库地图
| 路径 | 目的 | 许可证 | 测试 |
|---|---|---|---|
| `skill/` | 核心方法论 + 7个MCP工具 | Apache-2.0 | 41/41 |
| `modex/` | 多智能体运行时环境 + 插件许可证 | MIT(核心)+ BSL(插件) | 39/39 |
| `mcp-server/` | MCP/SaaS Beta基础 | MIT | 5/5 |
| `registry/` | FDE Assurance Score条目 | Apache-2.0 | 3/3 |
| `docs/` | 架构图 | Apache-2.0 | 无 |
| `.claude-plugin/` | Claude Code市场元数据 | Apache-2.0 | 无 |
---
## 定价(公共目录)
| 产品 | 许可证 | 价格 | 状态 |
|---|---|---|---|
| **FDE技能** (`skill/`) | Apache-2.0 | 免费 | 已准备好发布 |
| **Modex 1智能体运行时环境** (`modex/`) | MIT | 免费 | 已准备好发布 |
| **Modex插件** (`modex/plugin/`) | BSL 1.1 | 6美元 生命周期 | 已准备好发布 |
| **Modex集体插件** | BSL 1.1 | 260美元 生命周期 | 等待名单V1.2 |
| **MCP云 + 信任注册表** | BSL 1.1 | 99-499美元/月 | 等待名单V1.2 |
| **企业服务** | 自定义 | 按需报价 | 等待名单V1.2 |
参见 [`modex/PRICING.md`](modex/PRICING.md) 和 [`modex/LICENSE-SYSTEM.md`](modex/LICENSE-SYSTEM.md),了解ed25519许可证机制。
---
## 状态(此技能为V1.0.0)
| 组件 | 状态 | 测试 | 许可证 |
|---|---|---|---|
| FDE技能 | ✅ 已准备好发布 | 41/41 | Apache-2.0 |
| Modex 1智能体 | ✅ 已准备好发布 | 39/39 | MIT |
| MCP服务器Beta | ⚠️ Beta(本地CORS,模拟Stripe) | 5/5 | MIT |
| 信任注册表 | ✅ 已准备好发布 | 3/3 | Apache-2.0 |
| Modex插件(6美元 生命周期) | ✅ 已准备好发布(ed25519占位符) | 已包含 | BSL 1.1 |
| MCP云(99-499美元/月) | 🔮 等待名单V1.2 | 无 | BSL 1.1 |
| 企业 | 🔮 等待名单V1.2 | 无 | 自定义 |
参见 [`STATUS_V1.md`](STATUS_V1.md),获取完整的诚实状态报告。
---
## 贡献
该项目遵循其自身的 [操作原则](skill/SKILL.md#operating-principles-non-negotiable) 和 [反模式](skill/SKILL.md#anti-patterns-never-produce)。
阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md),获取四步检查PR流程:
1. **可证伪的声明**(更改内容)
2. **3种失败模式**(可能出错的内容)
3. **证据链**(文件:行 + 测试命令)
4. **反模式检查**(无流行词汇,无自我认证)
---
## 安全
参见 [`SECURITY.md`](SECURITY.md)。向 `security@selectess.dev` 报告漏洞。
**已知限制**(在 `STATUS_V1.md` 中声明):
- `modex/license.py:EMBEDDED_PUBLIC_KEY_HEX` 是开发的**占位符**。在任何付费发货前请替换。
- `modex/stripe_webhook.py` 在开发中使用 **模拟Stripe**。在生产环境中请替换为真实的Stripe API密钥。
---
## 许可证(多层)
- [`skill/`](skill/) — Apache-2.0(开源方法论 + 工具)
- [`modex/`](modex/)(核心运行时环境) — MIT(免费使用)
- [`modex/plugin/`](modex/)(插件) — BSL 1.1(6美元 生命周期,参见 [LICENSE-SYSTEM.md](modex/LICENSE-SYSTEM.md))
- [`marketing/landing/assets/`](marketing/landing/assets/) — CC-BY-4.0
参见 [`LICENSE`](LICENSE), [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)。
---
## 与AI实验室技能生态系统的兼容性
FDE顾问协议与官方技能生态系统**互补**:
| 生态系统 | 焦点 | 信任模型 |
|---|---|---|
| [`anthropics/skills`](https://github.com/anthropics/skills) | 领域技能(PDF,docx,pptx,...) | Anthropic QA |
| [`modelcontextprotocol/servers`](https://github.com/modelcontextprotocol/servers) | MCP服务器目录 | 每个服务器 |
| [`openai/openai-agents-python`](https://github.com/openai/openai-agents-python) | 多智能体SDK | OpenAI |
| **FDE顾问协议(此)** | **工程方法论 + 信任注册表** | **SHA-256 + 独立认证者** |
在您的问题是 *"交付经过验证的可用代码"* 时,请使用FDE顾问协议。
在您的问题是 *"很好地完成单个文档任务"* 时,请使用官方技能。
---
## 链接
- [什么是技能?](https://support.claude.com/en/articles/12512176-what-are-skills) — Anthropic支持
- [模型上下文协议](https://modelcontextprotocol.io) — MCP规范
- [DeepSCR FDE Assurance Score](https://en.wikipedia.org/wiki/Scientific_method) — 方法论灵感
- [Palantir FDE](https://www.palantir.com/) — FDE角色起源
- [FDE职位增长](https://www.tryexponent.com/blog/what-is-a-forward-deployed-engineer) — 市场数据
---
<sub>最后更新:2026-06-23 · 使用工业级严谨构建 · 通过116/116测试验证 · FDE Assurance Score 100/100 · Apache-2.0(技能)+ MIT(Modex核心)+ BSL(插件)</sub>