# AI 实践学习之后，怎样把作品交接给同事？

把运行环境、样例、权限、失败处理和维护责任随作品一起留下。

要点：交接一个 AI 作品，需要同时交接任务说明、运行环境、输入输出样例、权限与费用、失败处理和维护责任。让接收人依据说明独立运行，再修订遇到的问题。演示成功与同事能够持续使用，是两个不同的完成标准。

![同事交接纸质资料夹与电子设备（AI概念配图）](/images/guides/covers/ai-workflow-handover-v2.png)

## 说明作品适合做什么

写清作品要解决的任务、适用对象和不支持的情况，列出运行平台、版本与依赖。接收人应该知道要准备哪些资料，以及结果会保存或发送到哪里。

账号和密钥通过企业允许的方式交接，不放进公开说明或源码。费用归属、访问范围与需要重新申请的权限单独列出，避免作品离开制作人的环境就无法使用。

## 安排接收人独立运行

用一份正常样例和一份缺失或异常样例验证。交付者先观察，不代替操作，把接收人每次需要追问的问题记录下来：缺配置、找不到资料，或不知道怎样核对结果。

正常样例用于检查产出，异常样例用于检查是否知道何时停止和求助。涉及业务写入或对外发送时，应按约定测试方式验证，不能为了展示而直接操作真实客户事项。

## 留下后续维护入口

交接记录包含负责人、版本、问题反馈位置与修订日期。常见报错应有可理解的处理方式，模型或插件变化后也需要说明由谁复测。

下方清单可下载到表格软件，补充责任人与证据位置。它是通用交接模板，具体课程或服务交付仍按实际范围确认。准备共享作品时，再核对第三方素材、依赖许可与敏感信息。

## 把说明写给第一次接手的人

制作人熟悉的操作未必对接收人明显。说明中给出从哪里进入、先准备什么、输入放在哪里、运行后检查哪一项。截图可以定位入口，文字则解释当前步骤需要作出的判断。不要只截最终成功页面，缺少中间条件会让作品难以复现。

接收人与制作人使用不同账号时，需要验证可见范围和资源归属。个人空间里能运行的流程，转入团队空间后可能找不到连接、文件或模型配置。将迁移与重新授权作为独立事项记录，而不是简单复制一个分享链接。

![接手作品的操作入口、正常验证与异常处理](/images/guides/details/handover-recipient.svg)

让接收人实际操作，才能发现说明中遗漏的条件。

## 交付清单要有证据位置和接收结论

“已提供文档”只能证明文件存在。更有用的记录是说明文件在哪里、接收人用哪个版本运行、遇到什么问题以及是否已修正。对于需要账号授权的步骤，记录申请方式与负责角色，不在表格里填入令牌或密码。

可以为正常运行、异常输入和维护操作各保留一条验证结果。接收人不需要会修改所有底层代码，但应知道哪些错误可以自行处理，哪些需要转给维护人员。课程作品与企业正式应用的交付深度不同，应按实际目标确认。

| 检查内容 | 可留存的证据 | 接收人应能做到 |

| --- | --- | --- |

| 启动条件 | 环境和配置说明 | 独立准备并进入作品 |

| 正常任务 | 输入与合格结果样例 | 判断输出是否可用 |

| 失败处理 | 异常样例及处理记录 | 停止、补充或找到负责人 |

| 后续维护 | 版本与变更入口 | 识别当前版本并反馈问题 |

## 交接之后，用小范围复测承接变化

模型、插件或资料更新后，原来的结果可能变化。保留一组典型样例，并记录上次通过的版本，维护人员就能比较变化发生在哪个环节。对影响正式业务的修改，先在测试范围验证，再按企业已有发布方式启用。

生态可以围绕持续学习和问题修订安排交流、协助咨询与评审，具体响应、人员投入与范围按约定执行；技术维护另列。作品说明应能在服务结束或人员更换后继续使用，不能把维护入口仅留在某位同事的私人聊天记录里。

## 让接收者独立运行一件作品

连同环境、样例、权限、费用、失败处理与维护人一起交接，请未参与制作的同事完成正常和异常两类任务。课堂作品、企业建设和约定咨询分别核对，不能以演示成功代替正式交付。

## 参考来源

- [秩启｜成果营](/program)：四天三夜后另计40个工作日协助咨询；企业主建，8项基础成果加企业选择1–2项优先流程；技术实施另列

- [秩启｜生态](/ecosystem)：常态化学习、交流、协助咨询与评审按约定提供；成果营含首年生态费，第二年续费前确认范围与费用，不自动扣费

## 交接时一起留下

- 能启动：环境、配置与必要授权

- 能核对：正常和异常样例

- 能维护：负责人、版本与问题入口

![交接时一起留下](/images/guides/diagrams/ai-workflow-handover.svg)

[下载作品交接清单（CSV）](/documents/ai-handover-checklist.csv)

## 继续阅读

- [企业提示词怎么写？说清任务、依据和输出要求](/guides/prompt-design)

- [分享 AI 工作流和源码前，先检查这些内容](/guides/source-sharing)

- [新员工培训如何使用企业知识库？把提问接到实际工作](/guides/knowledge-onboarding)

四天三夜后另计40个工作日协助咨询；企业主建，技术实施另列，条件充分可直接申请。

下一步：[了解成果营与申请条件](/program)

原文：/guides/ai-workflow-handover

内容版本：guide:ai-workflow-handover:v1

<!-- version:guide:ai-workflow-handover:v1 -->

[结合企业情况咨询](/intake?source=%2Fguides%2Fai-workflow-handover&articleId=guide%3Aai-workflow-handover&versionId=guide%3Aai-workflow-handover%3Av1)