FDE Skills

面向 Forward Deployed Engineer 与企业 AI 落地工程师的开源技能库和交付框架。

简体中文 · English · FDEChina.ai · 全部 Skill · 使用文档 · 参与贡献

面向 Forward Deployed Engineer / 企业 AI 落地工程师的开源 Skill Library 与 Delivery Framework。让 Codex、Claude Code、Cursor、OpenCode 等 AI Coding Agent 按照标准化 FDE 方法，完成企业需求诊断、方案设计、开发、评测、部署和交付。

FDE Skills 不只是教 AI 怎么写代码，而是教 AI 如何像一个 Forward Deployed Engineer 一样进入企业、理解业务、设计方案、构建系统、验证价值并完成交付。

可以用它做什么

• 从客户需求出发，形成企业诊断、AI 场景地图、PoC 范围和交付计划。
• 设计企业知识库、RAG、Agent、工具、权限模型与人工复核流程。
• 构建评测数据集，验证检索、幻觉、任务成功率、安全与成本。
• 准备部署上线、生产验收、服务等级和交付移交。
• 复用行业知识，将真实项目经验沉淀为可持续维护的 Skill。

当前能力

Skill 的 ready 状态表示已编写并通过结构校验，不代表经过客户现场验证。案例数据和评测结果默认属于合成教学样本，真实验证须另行记录证据。

项目架构

图中展示仓库已实现的工具链。原生客户端的运行表现仍需独立验证；查看全部图解与可编辑源文件。

快速开始

需要 Python 3.10+。在本仓库目录执行：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[dev]'

fde list
fde search rag
fde show enterprise-ai-diagnosis
fde validate

Windows PowerShell 使用 .venv\Scripts\Activate.ps1 激活虚拟环境。

将 Skill 导出到已有项目：

fde export codex --skill enterprise-ai-diagnosis --output ../customer-project
fde export claude-code --industry foreign-trade --output ../customer-project
fde export cursor --skill rag-architecture --output ../customer-project
fde export opencode --skill delivery-handover --output ../customer-project

导出内容包括平台原生 SKILL.md、完整 FDE 契约、示例、模板和许可声明。CLI 在本地运行，无需模型调用或密钥。平台目录和导出行为详见适配说明。

Skill 如何工作

每个标准 Skill 位于 skills///SKILL.md。Markdown 正文与 YAML Front Matter 共同定义使用场景、输入、输出、工作流、约束、工具和评测标准；配套文件提供完整示例和交付模板。

需求 → Discovery → Diagnosis → Solution → Architecture → Build → Eval → Deploy → Delivery

每个阶段都需要证据、负责人和明确的通过或不通过结论。缺少输入时输出缺口清单，评测失败时先修复再推进。详见交付框架和 FDE Skill Specification。

完整的 60 个 Skills 见索引，也可以使用 fde search 查找。

行业扩展与交付案例

行业 Pack 引用核心 Skill，追加行业知识、约束、指标、术语和案例，避免重复维护相同流程。机制详见行业 Pack 规范。

每个案例都包含 Discovery、Diagnosis、Solution、Architecture、Build、Eval、Deploy、Delivery 的完整过程：

1. 企业 AI 诊断
2. 企业知识库
3. 外贸销售 Agent
4. 医美咨询与预约 Agent
5. 制造业知识 Agent

python scripts/run_example.py 02-enterprise-knowledge-base

案例可以离线复现，包含故意失败的基线，用于演示契约和交付门槛。生产模型质量与业务效果仍需使用真实系统和经过授权的数据验证。

应用参考架构：企业知识 Agent

这张图展示可由 Skills 指导设计的应用架构。运行组件由客户项目实现与验证；本仓库提供方法、契约、模板和离线示例。

仓库结构

fde-skills/
├── skills/          # 12 类标准 Skill 源定义
├── industries/      # 5 个行业扩展包
├── adapters/        # Codex、Claude Code、Cursor、OpenCode 适配配置
├── templates/       # Skill 模板与交付记录
├── examples/        # 5 个完整交付案例
├── schemas/         # Skill、示例和行业 Pack 的 JSON Schema
├── src/fde_skills/   # CLI 与离线案例基线
├── scripts/         # 校验、索引与案例执行入口
├── tests/           # 契约、CLI、适配与回归测试
├── docs/            # 概念、规范、教程与迁移历史
├── legacy/          # 保留的历史资产与上游声明
└── skills.json      # 自动生成的搜索与集成 Registry

参与贡献

欢迎用中文或英文参与：完善 Skill、补充经过验证的失败案例、扩展行业 Pack、改进 Adapter，或修正文档。从贡献指南和如何贡献自己的 FDE Skill开始。

fde skill create supplier-onboarding --category discovery
# 完善草稿、交付模板和正反例后，再生成索引。
fde registry build
fde validate
pytest -q
ruff check src tests scripts setup.py

fde skill create 不带名称时进入交互；fde init ./my-library 可初始化独立的 Skill 库。统一维护 skills/ 源文件，再生成衍生产物。问题与提案请提交 Issue，代码和内容改进请提交 Pull Request。

Roadmap

查看完整 Roadmap、更新日志和验证记录。

作者与社区

作者 / 维护者：邴越（Bing Yue）。 欢迎 FDE 社区共同建设和维护。

• FDEChina.ai · FDE中国社区：企业 AI 落地案例、方法、学习资源与社区交流入口。
• FDE前线：微信公众号、视频号，搜索 「FDE前线」 关注。
• FDE Skills GitHub 仓库：获取源码、使用 Skills、提交提案和参与贡献。

欢迎工程师、业务实践者与行业专家，把项目经验转化为可复用、可验证的 FDE Skills。仓库问题通过 GitHub 协作，FDE 方法与实践交流可以通过社区参与。

开源协议

Copyright © 2026 邴越（Bing Yue）及 FDE Skills 贡献者。

当前原创的 FDE Skills 库、CLI、文档、模板和示例采用 GNU Affero General Public License v3.0 only（AGPL-3.0-only），完整条款见 LICENSE。

修改后的受许可程序若支持用户通过网络远程交互，须按照 AGPL 第 13 条向这些用户提供获取对应源代码的机会。分发和其他要求以许可证全文为准。

历史第三方材料保留原有条款，不进入受支持的安装包和 Adapter 导出；此前已授予的许可不会被撤销。来源与适用范围见 NOTICE、来源记录及迁移记录。