← 交付方法总览
方法论可泛化原则
产物体系(Artifact System)
横切
把交付过程中产生的东西定义成有结构的资产:哪些必须产出、各自的形态是什么、谁维护、如何在下一个项目复用。目的是让交付结束时留下的不只是代码。
什么时候需要它
- 项目要移交,但不确定该交出哪些东西
- 上一个项目的经验在新项目里完全用不上
核心内容
它决定什么
公开的是判断与判据。客户口径、私有阈值和内部示例不在其中。
资产不等于文档
能变成可运行的东西就不要只写成文档:Eval 用例集、校验脚本、门禁配置、起步模板,价值都高于同等篇幅的说明文字。
通用层与项目层分离
可复用资产里不能混入客户专属口径、私有阈值和实体命名。混进去之后要么无法复用,要么复用时把上一家的假设带到下一家。
每个资产有维护者
无人维护的资产会在几个月内失真,而失真的资产比没有资产更危险,因为它仍然被当成依据引用。
Handoff 是一等交付物
移交材料不是项目末尾顺手写的,而是从一开始就在积累的。判据是接手方能独立复现关键结论。
有出处与版本
资产里的结论要能追到来源与时间。前提变了但结论还在被引用,是长期项目里最隐蔽的错误来源。
怎么判断它真的到位
- 能列出本项目必须产出的资产清单,且每项有维护者
- 可复用资产里不含任何客户专属命名或阈值
- 接手方能仅凭资产复现至少一个关键结论
常见误区
- 把所有经验都写成文档,没有一条变成可运行的东西
- 复用时把上一个项目的专属假设一并带过去
- 资产没有出处与时间,多年后无人敢改也无人敢信
这套方法怎么落到你的项目
这是我们交付生产级 AI Agent 的公开、脱敏方法骨架。真正落地时,从 AI Agent 生产就绪审查与路线图 入手,或先用 生产上线前深检 定位薄弱环节。
