FDEOps (Forward Deployed Engineering Operations) 是一个专为在客户现场工作的 AI 编程助手设计的技能套件。它不是一个代码生成工具，而是一个流程管理工具，帮助你围绕代码进行客户沟通、需求确认、交付追踪和项目收尾。它确保你在客户现场工作的每一步都有记录、有确认、有交接。

核心概念与工作流程

理解 FDEOps 的设计哲学是正确使用它的第一步：

  • 与 AI 编程助手协同工作：你仍使用你习惯的 AI 编程工具（如 Claude Code、Cursor 等）编写代码。FDEOps 运行在代码编写之外，负责管理“客户工作”：需求简报、决策者、验收标准、部署确认和交接文档。
  • 数据存储：所有项目记录以纯文本 Markdown 文件的形式，按客户组织，存储在你本地电脑的 ~/fde-engagements/ 目录下。数据完全归属你自己，不会上传到任何外部网络。
  • 核心理念：
    • 先确认，后记录：任何重要决策或行动，都需要你确认后，FDEOps 才会写入文件。
    • 有日期，才算发生：所有关键事件（承诺、测量、验收）都带有时间戳。
    • 一个客户，一个文件夹：客户上下文完全隔离，不会混淆。

安装与初始配置

FDEOps 是一个基于 Node.js 的工具，安装非常轻量。

前提条件：

  • 需要 Node.js 版本 >= 18。可通过 node --version 检查。

全局安装 (推荐)：
使用 npm 或 npx 可以快速安装并运行。

1
2
3
4
5
# 1. 安装 FDEOps 技能到你的 AI 助手 (以 Claude Code 为例)
npx skills add suboss87/fdeops --skill fde

# 2. 在任意 Git 仓库中测试，确认安装成功且环境就绪
npx fdeops scan

npx fdeops scan 命令会在当前目录生成一份快速的“项目状态扫描”，展示你应该关注的初始事项和需要提问的问题，整个过程不会写入任何文件，是一个安全的检查。

为特定 AI 助手安装 (Claude Code / Cursor)：

  • Claude Code

    1
    2
    3
    # 通过插件市场安装
    /plugin marketplace add suboss87/fdeops
    /plugin install fdeops@fdeops

    安装后，Claude Code 会加载相应的斜杠命令（如 /brief, /plan）和会话钩子。

  • Cursor

    1
    2
    # 在项目目录中运行适配器
    npx fdeops adapters .

    这会为 Cursor 生成必要的配置，使其能理解 FDEOps 的指令。

开始使用：启动一个新客户项目

  1. 告知 AI 新客户：在你与 AI 助手的对话中，使用 @fde 引用 FDEOps 技能，并明确说明这是新客户。

    1
    @fde this is client01

    此命令会在 ~/fde-engagements/client01/.fde/ 目录下创建该客户的专属文件夹和初始记录文件。

  2. 输入项目简报：在同一个对话线程中，粘贴你的客户会议记录、需求文档或口头需求。

    1
    @fde [粘贴你的简报内容]

    FDEOps 会分析这些信息，并填充到相应的记录文件中（如 brief.md、stakeholders.md）。

核心命令与工作阶段

FDEOps 将客户项目分为六个标准阶段，每个阶段都有对应的命令，确保流程完整。

阶段 命令 目的 关键产出
入场 (Land) /brief 获取项目简报，明确“谁说了算”。 明确项目目标、范围和决策者。
探索 (Discover) /discover 验证简报内容是否与实际工作相符。 识别隐藏需求、假设和潜在风险。
规划 (Plan) /plan 根据最终目标，逆向规划工作步骤。 生成可执行的、以终为始的工作序列。
交付 (Ship) /ship 在客户预发布环境验证，然后正式上线。 确认交付内容、部署步骤和回滚方案。
成果 (Outcome) /outcome 衡量承诺是否达成，并由客户方签字验收。 记录“承诺-度量-验收”的完整证据链。
收尾 (Close) /close 完成知识转移和交接，确保客户能独立运维。 生成交接文档、运维手册，结束项目。

常用支持命令：除了核心六阶段命令，还有一些日常使用的辅助命令：

  • /debrief：将会议记录或对话内容整理后归档。
  • /prep：在会议或重要行动前，生成一页简报，帮助你理清思路。
  • /trust：当出现信任问题或流程卡壳时，调用此命令来诊断和处理。
  • /receipts：生成一条带日期的记录，用于追溯关键事件。

进阶用法与定制

  • 离线/内网环境：如果网络受限，可以直接克隆仓库并本地安装。

    1
    2
    3
    git clone https://github.com/suboss87/fdeops.git
    cd fdeops
    node bin/install.js

  • 环境变量覆盖：通过设置 FDEOPS_ENGAGEMENT 环境变量，可以指定客户文件夹的位置，方便管理不同客户。

  • 试验工作流：使用 npx fdeops demo 命令，可以体验一个完整的模拟项目流程，熟悉所有命令和交互方式。

故障排查与注意事项

  • “命令未找到”错误：确保 Node.js 版本 >= 18。如果使用 npx 失败，可以尝试全局安装：npm install -g fdeops。
  • AI 助手无法加载技能：检查技能是否正确安装到对应助手的技能目录（如 Claude Code 的 ~/.claude/skills/）。确认在对话中正确使用了 @fde 来调用技能。
  • 数据隐私：FDEOps 的设计前提是所有记录存储在本地。请确保你的 ~/fde-engagements/ 目录没有被任何云同步服务（如 iCloud、Dropbox）自动同步，以避免潜在的客户数据泄露风险。敏感信息请使用 <private> 标签标记，这些内容会被 CLI 和仪表板自动屏蔽。
  • 它不是项目管理工具：FDEOps 的核心是轻量级的记录和流程引导，而不是一个完整的项目管理（如 Jira）或文档管理平台。它专注于关键信息的确认和追踪。

总而言之，FDEOps 更像是一个**“客户现场工作操作系统”**，它用一套轻量级的规则和命令，帮助你在使用 AI 编程助手时，不遗漏任何关键的客户沟通和项目治理环节。它适合需要频繁与客户协作、进行现场交付的开发人员或顾问。请从简单的 npx fdeops scan 开始尝试，逐步熟悉其工作流。