关于 forward-deployed-engineering
面向需要持续推进的嵌入式技术合作,覆盖从发现问题到部署、采用、衡量及推广决策。它适用于在客户工作流中交付方案的团队,以阶段门槛、证据记录、权限检查和交接维持连续性。
主要功能
- 01九阶段合作生命周期
- 02阶段进入与停止条件
- 03共享章程、流程图和风险台账
- 04基于证据的阶段交接
- 05权限与升级检查
- 06采用情况和结果衡量
适用场景
- 01管理嵌入式客户交付
- 02跟踪合作各阶段的决策
- 03检查发布准备度和采用情况
- 04判断现场经验是否可复用
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ magnus919/ agent-skills --skill forward-deployed-engineering安装后在 Claude Code 中输入/forward-deployed-engineering确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
AGENTS.mdmanifest.yamlREADME.mdevals/evals.jsonreferences/adoption-and-measurement.mdauthority-and-escalation.mdcommunication.mddiscovery-brief.mdgeneralization-and-productization.mdlifecycle-and-artifacts.mdroute-selection.mdsource-index.mdworked-example-engagement.mdtemplates/adoption-scorecard.mdassumptions-decisions-risks-ledger.mdengagement-charter.mdengagement-status.mdevaluation-and-release-decision.mdfield-learning-record.mdoutcome-measurement-record.mdproductization-record.mdstage-handoff-record.mdstakeholder-workflow-map.md详细介绍
前沿部署工程
当工作属于嵌入式技术合作,且成功取决于持续跟进,而不仅仅是提出建议或修改代码时,请使用此流程包。这是一套规范性运营模型,综合了 source-index.md 中对该角色的观察和经路由的专家方法;其中的九阶段流程并非外部标准化的方法论。
生命周期
发现 → 界定 → 提出假设 → 构建 → 评估 → 部署 → 采用 → 衡量 → 推广
| 阶段 | 必须回答的问题 | 最低产出 | 停止条件 |
|---|---|---|---|
| 发现 | 真实的用户工作流和问题是什么? | 利益相关者/工作流映射和待解明事项 | 无法识别出明确的问题,或无法接触相关工作流 |
| 界定 | 范围是什么、由谁决策、什么结果最重要? | 合作章程和假设/决策/风险台账 | 无法明确授权、约束或目标结果 |
| 提出假设 | 哪种最小干预可能改变工作流? | 可检验的假设和决策规则 | 没有可证伪的假设,或测试不安全 |
| 构建 | 可以构建哪种运营上完整的最小切片? | 最小切片实施计划和负责人 | 依赖项或权限无法满足 |
| 评估 | 有什么证据能证明质量、安全性和实用性? | 评估与发布决策 | 缺少基线、代表性证据或风险约束 |
| 部署 | 能否在获授权的环境中发布、恢复并验证? | 准备就绪、推出、回滚和验证记录 | 缺少授权访问权限、回滚机制或发布决策 |
| 采用 | 目标用户是否会在目标工作流中启用并使用它? | 采用情况评分卡和干预记录 | 采用失败原因不明,或缺少负责人/支持 |
| 衡量 | 该能力是否改变了商定的结果? | 结果衡量记录 | 监测手段无法区分预期结果与观测结果 |
| 推广 | 如何处理本地经验? | 产品化记录和现场经验记录 | 提议的下一步缺少证据或接手负责人 |
在每个阶段,都要查阅当前的章程、工作流映射和台账,并补充证据,而不是重新推导先前的决策。始终维护一份合作章程、一份利益相关者/工作流映射和一份假设/决策/风险台账。每个阶段都要记录进入阶段的证据、产出的文档、负有问责责任的决策者、尚未解决的问题以及下一步交接事项。绝不能悄然将观察结果变成需求、将原型说成生产成果,或将本地成功说成可复用的产品能力。有关这些文档所需的深度和证据标注,请参阅合作实例。
从哪个阶段进入生命周期
从与现有进展相符的阶段进入。除非当前章程的停止条件要求,否则不要重新开始较早的阶段。
| 现有内容 | 从以下阶段进入 |
|---|---|
| 利益相关者的请求或观察到的工作流机会,尚未验证问题 | 发现 |
| 已验证问题和利益相关者,尚无章程 | 界定(先确立章程) |
| 已有章程、工作流图和台账;尚无获批的需求 | 提出假设 |
| 需求已获批;精简切片正在进行 | 构建 |
| 切片已构建并测试;尚无发布决定 | 评估 |
| 已在授权范围内发布 | 采用 |
| 已采用,并根据决策规则进行衡量 | 衡量 |
| 已有上线后证据,并有一个泛化问题 | 泛化 |
| 变更范围明确且有限,也无需保持连续性 | 改为转交给 neckbeard |
在任何入口点采取行动之前,请审查当前章程、工作流图、台账,以及前一阶段的交接记录,作为进入阶段的依据。
加载协议
- 在设计解决方案之前确立章程:问题、用户、工作流、结果、范围、权限、约束、成功衡量指标和停止条件。
- 加载生命周期和工件,并在每个阶段结束后更新共享台账。
- 将
manifest.yaml中的阶段技能视为候选项。应用路线选择条件,加载一项主要专长技能,并遵循其方法,而不是将其复制到此技能包中。 - 在受限或敏感环境中采取行动之前,加载权限和升级处理,并将访问、安全、隐私、不可逆、成本和外部承诺相关决策交由获授权的负责人处理。
- 在将应用型 AI 或任何高风险能力视为可用于生产之前,加载 agent-evals-and-observability 和 production-readiness,并要求提供基线、代表性和对抗性证据、约束,以及发布决定。
- 将采用和对工作流影响的衡量视为完成条件,而不是事后沟通。使用采用和衡量。
- 应用泛化和产品化中的分类规则,然后使用产品化记录完成收尾。根据证据和负责人,将本地工作分类为配置、可复用模式、产品能力、转移/替换或退役。
- 默认将工件视为私有;在工件离开获授权的合作场景之前,先通过对外共享关卡。
仅加载当前阶段的主要专长技能。只有存在明确的阻碍、风险或交接需求时,才添加次要专长技能;不要预先加载清单中的所有技能。如果某项专长技能能够完整负责该请求,请停止路线选择,并将任务交给该技能,而不是运行 FDE 生命周期。
认知与沟通约定
将每条重要陈述标记为以下类型之一:来源事实、合作观察、推断、建议、决定或承诺。使用沟通参考发布简明的状态更新和升级说明。发现简报记录重叠审计和来源限制。
完成与停止规则
只有在能力经过技术验证、在授权边界内完成部署、被预期工作流采用、依据商定的结果进行衡量,并对其经验是否推广作出决定后,此次合作才算完成。原型、演示或利益相关方批准本身都不代表完成。
如果无法清晰阐述问题、缺少授权或访问权限、证据不成立、采用情况仍无法解释或低于决策标准,或下一步行动超出章程范围,则停止并保留记录。在安全、隐私、不可逆更改、重大成本、对外承诺或业务授权方面,不要猜测,应升级处理。对于定义明确的代码库错误,直接交由 neckbeard 和相关专家处理,不要启动此生命周期。
何时不应使用
| 场景 | 应使用 | 原因 |
|---|---|---|
| 范围明确的代码库更改 | neckbeard | 负责范围明确的更改,从受理到经过验证的 PR 和授权发布 |
| 产品投资、投资组合或生命周期治理 | product-lifecycle | 负责投资和生命周期治理,而非交付连续性 |
| 持续的可靠性责任(SLO、警报、事件) | site-reliability-engineering | 负责持续的运营,而非嵌入式合作 |
| 内部平台设计或运营 | platform-engineering | 负责平台,而非客户交付 |
| 任务完全由一个专业领域负责 | 直接联系该领域专家 | 如果某位专家负责该请求,FDE 就不再负责路由 |
| 在实施和采用之前结束的咨询分析 | 相关架构或决策专家 | FDE 的完成条件要求持续跟进采用情况和结果 |
文件索引
| 路径 | 在何时加载 |
|---|---|
| references/discovery-brief.md | 审查边界、重叠审计或证据依据时 |
| references/source-index.md | 核查可从外部验证的角色声明或刷新日期时 |
| references/lifecycle-and-artifacts.md | 启动或移交任何生命周期阶段时 |
| references/route-selection.md | 选择某个阶段的专家,同时确保不违反其准入边界时 |
| references/authority-and-escalation.md | 在访问权限、安全、隐私、成本或授权受限的情况下开展工作时 |
| references/adoption-and-measurement.md | 评估启用情况、工作流采用情况和可衡量的影响时 |
| references/generalization-and-productization.md | 决定现场工作是否转化为可复用成果时 |
| references/communication.md | 撰写状态、决策、升级处理或移交沟通内容时 |
| references/worked-example-engagement.md | 校准任一阶段预期的工件深度或证据标注时 |
| templates/ | 创建章程、工作流图、记录簿、阶段移交、合作状态、评估与发布决策、采用情况评分卡、结果衡量记录、产品化记录或现场经验记录时 |
| manifest.yaml | 查看机器可读的阶段、路由、输出和冲突时 |