FDEstack 是一个专为现场工程师 (Forward-Deployed Engineers, FDEs) 设计的 Claude Code 技能包。它提供了一套结构化的工作流，帮助你管理客户上下文、进行问题发现、界定范围、构建价值框架、执行概念验证 (POC) 和集成，所有数据都存储在你自己本地的 Git 仓库中。本教程将指导你完成部署和核心使用。

核心概念与工作流程

FDEstack 的设计旨在解决现场工程师普遍面临的“上下文丢失”和“跨客户经验无法积累”的痛点。

  • 核心理念：将客户工作视为一个可管理的工程项目，用 Git 管理客户上下文。每个客户的所有信息（决策、未知项、时间线）都作为结构化 Markdown 文件存储在本地 Git 仓库中。
  • 八个核心技能：围绕一个典型客户项目的完整生命周期，提供一系列斜杠命令 (/skill)。这些技能共同构成了一个闭环：
    1. 客户上下文 (/customer-context)：加载或创建客户档案，打印会话简报。
    2. 发现 (/discovery)：处理会议记录等来源，提取真实问题与未知项。
    3. 界定范围 (/scope)：强制将问题转化为带有二进制成功标准的可执行范围。
    4. 价值框架 (/value-frame)：将机会量化，建立可防御的商业价值论证。
    5. 概念验证 (POC) (/poc)：快速构建一个可丢弃的 POC，并强制进行学习总结。
    6. 集成 (/integrate)：基于范围和决策，在“洁净室”环境中重建生产级代码，绝不直接读取 POC 代码。
    7. 分类 (/triage)：提供跨客户的组合视图，按紧急程度排序。
    8. 客户回顾 (/engagement-retro)：进行每周客户回顾，提炼经验并识别新风险。

第一步：安装与初始配置

安装过程非常迅速，本质上是将技能包克隆到本地并链接到 Claude Code。

  1. 克隆 FDEstack 仓库：

    1
    2
    git clone https://github.com/Dan-Cleary/fdestack.git ~/fdestack
    cd ~/fdestack

  2. 运行安装脚本：

    1
    bash setup

    此脚本会将 skills/ 目录下的所有技能（如 customer-context、discovery 等）通过符号链接 (symlink) 安装到 ~/.claude/skills/ 目录中，使 Claude Code 能够识别它们。

  3. 初始化你的私有操作仓库：
    这是存储所有客户数据的地方。运行以下命令来创建一个新的 Git 仓库（或关联到现有目录）。

    1
    bash ~/fdestack/init-ops-repo

    这通常会创建一个 ~/fde-ops/ 目录，并完成 Git 初始化。所有客户上下文都将存储在这里。

第二步：开始一个客户项目

  1. 进入你的操作仓库并启动 Claude：

    1
    2
    cd ~/fde-ops
    claude

  2. 创建或加载客户上下文：
    这是最重要的一步，你总是先运行这个命令来开始任何客户工作。

    1
    /customer-context acme

    将 acme 替换为你的客户代号。此命令会：

    • 如果客户不存在，则在 customers/acme/ 下创建一系列模板文件（如 profile.md, stack.md）。
    • 如果客户已存在，则加载其上下文，并打印一份会话简报（包括当前阻塞项、未知项和自上次会话后的变化）。

  3. 处理会议记录或简报：
    在会议后，将你的笔记或转录内容粘贴到以下命令中：

    1
    /discovery acme <粘贴你的会议记录或简报>

    FDEstack 会解析这些内容，提取新的技术栈信息、利益相关者，并区分用户陈述的问题和推断出的真实问题，同时生成新的未知项。

第三步：核心工作流循环

一个典型的现场工程师日常会反复使用以下技能，构成一个循环：

  1. 界定范围：在明确一个问题后，使用 /scope 来定义成功标准。

    1
    /scope acme "让风险委员会在2026-05-22前批准"

    该命令会强制要求提供二进制的成功标准（例如，“批准”或“未批准”），并将模糊的要求标记为高优先级未知项。

  2. 构建价值框架：当需要论证项目价值时，使用 /value-frame。

    1
    /value-frame acme "将上线推迟30天"

    它会强制选择一个主要的商业杠杆（时间、错误、资本等），并计算量化的价值和敏感性分析。

  3. 执行概念验证 (POC)：在需要快速验证时，使用 /poc。

    1
    /poc acme --purpose feasibility

    它会引导你构建一个“可丢弃”的 POC（注重速度而非质量）。最关键的是，它会在最后强制你进行学习总结，并将新发现（如技术约束、设计决策）写回到 stack.md 和 decisions.md 中，以确保这些经验不会丢失在 POC 代码里。

  4. 进行生产集成：当 POC 验证成功后，使用 /integrate 进行生产级构建。

    1
    /integrate acme

    该命令被设计为绝不会读取 customers/acme/poc/ 目录下的代码。它会依据 scope、stack、decisions 和 value-frame 中的结构化信息，从零开始重建一个健壮的实现。这确保了 POC 中的“快捷方式”（如硬编码值、忽略错误处理）不会“泄漏”到最终产品中。

  5. 查看所有客户状态：每天开始时，使用 /triage 查看全局。

    1
    /triage

    它会列出所有活跃客户，并根据阻塞项、未知项和近期里程碑计算紧急程度分数，帮你决定今天应该优先处理哪个客户。

  6. 进行客户回顾：每周结束时，使用 /engagement-retro 进行总结。

    1
    /engagement-retro acme

    它会引导你回顾本周“交付了什么 / 卡在了哪里 / 学到了什么 / 下一步做什么”，并自动将跨周未解决的议题标记为新的高优先级未知项。

故障排查与注意事项

  • Claude Code 无法识别 /customer-context 等命令：
    • 确保你已运行 bash ~/fdestack/setup，并且 ~/.claude/skills/ 目录存在且包含指向 FDEstack 技能的符号链接。
    • 确保你在 ~/fde-ops（或你初始化的工作仓库）目录下启动 claude。
  • Git 提交失败：所有技能在执行写入操作后都会尝试自动提交。请确保 ~/fde-ops 是一个有效的 Git 仓库，并且已配置好用户名和邮箱 (git config --global user.name 和 user.email)。
  • 数据隐私：所有数据仅存储在本地 (~/fde-ops/)。请确保该目录未被任何云同步服务（如 iCloud、Dropbox）同步，并且你对 customers/ 目录下的敏感信息进行适当的访问控制。
  • 与其他技能包（如 gstack）共存：FDEstack 的技能（如 /engagement-retro）与其他包（如 gstack 的 /retro）名称不同，作用域（客户工作 vs. 代码库工作）也不同，因此可以安全地同时安装。

总而言之，FDEstack 为现场工程师提供了一套轻量级、基于 Git 的工作流“操作系统”。它的核心价值在于将隐性的客户知识和经验转化为显式的、可积累的、可搜索的文本记录，并通过强制性的流程（如二进制成功标准、洁净室集成）来避免常见的现场交付陷阱。建议你从一个新客户开始，完整地运行一遍这八个技能，以体会其完整的闭环工作流。