mcpField
F
forward-deployed-engineering

forward-deployed-engineering

github.com/magnus919开发15366 次安装今天更新
代码仓库

关于 forward-deployed-engineering

面向需要持续推进的嵌入式技术合作,覆盖从发现问题到部署、采用、衡量及推广决策。它适用于在客户工作流中交付方案的团队,以阶段门槛、证据记录、权限检查和交接维持连续性。

主要功能

  1. 01九阶段合作生命周期
  2. 02阶段进入与停止条件
  3. 03共享章程、流程图和风险台账
  4. 04基于证据的阶段交接
  5. 05权限与升级检查
  6. 06采用情况和结果衡量

适用场景

  1. 01管理嵌入式客户交付
  2. 02跟踪合作各阶段的决策
  3. 03检查发布准备度和采用情况
  4. 04判断现场经验是否可复用

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill forward-deployed-engineering

安装后在 Claude Code 中输入/forward-deployed-engineering确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

AGENTS.md
manifest.yaml
README.md
evals/
evals.json
references/
adoption-and-measurement.md
authority-and-escalation.md
communication.md
discovery-brief.md
generalization-and-productization.md
lifecycle-and-artifacts.md
route-selection.md
source-index.md
worked-example-engagement.md
templates/
adoption-scorecard.md
assumptions-decisions-risks-ledger.md
engagement-charter.md
engagement-status.md
evaluation-and-release-decision.md
field-learning-record.md
outcome-measurement-record.md
productization-record.md
stage-handoff-record.md
stakeholder-workflow-map.md

详细介绍

前沿部署工程

当工作属于嵌入式技术合作,且成功取决于持续跟进,而不仅仅是提出建议或修改代码时,请使用此流程包。这是一套规范性运营模型,综合了 source-index.md 中对该角色的观察和经路由的专家方法;其中的九阶段流程并非外部标准化的方法论。

生命周期

发现 → 界定 → 提出假设 → 构建 → 评估 → 部署 → 采用 → 衡量 → 推广

阶段必须回答的问题最低产出停止条件
发现真实的用户工作流和问题是什么?利益相关者/工作流映射和待解明事项无法识别出明确的问题,或无法接触相关工作流
界定范围是什么、由谁决策、什么结果最重要?合作章程和假设/决策/风险台账无法明确授权、约束或目标结果
提出假设哪种最小干预可能改变工作流?可检验的假设和决策规则没有可证伪的假设,或测试不安全
构建可以构建哪种运营上完整的最小切片?最小切片实施计划和负责人依赖项或权限无法满足
评估有什么证据能证明质量、安全性和实用性?评估与发布决策缺少基线、代表性证据或风险约束
部署能否在获授权的环境中发布、恢复并验证?准备就绪、推出、回滚和验证记录缺少授权访问权限、回滚机制或发布决策
采用目标用户是否会在目标工作流中启用并使用它?采用情况评分卡和干预记录采用失败原因不明,或缺少负责人/支持
衡量该能力是否改变了商定的结果?结果衡量记录监测手段无法区分预期结果与观测结果
推广如何处理本地经验?产品化记录和现场经验记录提议的下一步缺少证据或接手负责人

在每个阶段,都要查阅当前的章程、工作流映射和台账,并补充证据,而不是重新推导先前的决策。始终维护一份合作章程、一份利益相关者/工作流映射和一份假设/决策/风险台账。每个阶段都要记录进入阶段的证据、产出的文档、负有问责责任的决策者、尚未解决的问题以及下一步交接事项。绝不能悄然将观察结果变成需求、将原型说成生产成果,或将本地成功说成可复用的产品能力。有关这些文档所需的深度和证据标注,请参阅合作实例。

从哪个阶段进入生命周期

从与现有进展相符的阶段进入。除非当前章程的停止条件要求,否则不要重新开始较早的阶段。

现有内容从以下阶段进入
利益相关者的请求或观察到的工作流机会,尚未验证问题发现
已验证问题和利益相关者,尚无章程界定(先确立章程)
已有章程、工作流图和台账;尚无获批的需求提出假设
需求已获批;精简切片正在进行构建
切片已构建并测试;尚无发布决定评估
已在授权范围内发布采用
已采用,并根据决策规则进行衡量衡量
已有上线后证据,并有一个泛化问题泛化
变更范围明确且有限,也无需保持连续性改为转交给 neckbeard

在任何入口点采取行动之前,请审查当前章程、工作流图、台账,以及前一阶段的交接记录,作为进入阶段的依据。

加载协议

  1. 在设计解决方案之前确立章程:问题、用户、工作流、结果、范围、权限、约束、成功衡量指标和停止条件。
  2. 加载生命周期和工件,并在每个阶段结束后更新共享台账。
  3. 将 manifest.yaml 中的阶段技能视为候选项。应用路线选择条件,加载一项主要专长技能,并遵循其方法,而不是将其复制到此技能包中。
  4. 在受限或敏感环境中采取行动之前,加载权限和升级处理,并将访问、安全、隐私、不可逆、成本和外部承诺相关决策交由获授权的负责人处理。
  5. 在将应用型 AI 或任何高风险能力视为可用于生产之前,加载 agent-evals-and-observability 和 production-readiness,并要求提供基线、代表性和对抗性证据、约束,以及发布决定。
  6. 将采用和对工作流影响的衡量视为完成条件,而不是事后沟通。使用采用和衡量。
  7. 应用泛化和产品化中的分类规则,然后使用产品化记录完成收尾。根据证据和负责人,将本地工作分类为配置、可复用模式、产品能力、转移/替换或退役。
  8. 默认将工件视为私有;在工件离开获授权的合作场景之前,先通过对外共享关卡。

仅加载当前阶段的主要专长技能。只有存在明确的阻碍、风险或交接需求时,才添加次要专长技能;不要预先加载清单中的所有技能。如果某项专长技能能够完整负责该请求,请停止路线选择,并将任务交给该技能,而不是运行 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查看机器可读的阶段、路由、输出和冲突时

评论

支持 Markdown