用途
Agent File Handoff 解决一个实际问题:项目经常收到 PDF、Markdown、导出记录、截图、ZIP 包或其他 AI 生成的文件,但如果这些文件没有写进聊天,下一位 AI 可能完全看不到。UAIX 的做法是在 Project Handoff 旁边增加本地 active intake 投递桶,让每次读取 AGENTS.md 时都先检查新文件,不依赖额外后台进程。
当前实现
agent-file-handoff/Content/放候选公开或编辑材料;agent-file-handoff/Improvement/放审计、SEO、QA、bug 和站点改进材料。agent-file-handoff/Archive/保留已经处理完的源文件;常规 AI intake 忽略它,除非人类明确点名某个归档文件,或把它移回 active 桶。scripts/Invoke-UaiFileIntake.ps1是一次性本地辅助脚本,只刷新.uai/intake-index.uai,列出路径、分类提示、大小、校验和以及needs-agent-review状态。- 它不会发布内容、把文件标记为可信、写 manifest,或依赖桶内 README 指令。
- 不要把 watcher、daemon、队列文件夹、cron 或常驻后台服务作为基础规范的一部分;规范要求是 AGENTS.md 加载时扫描 active intake,并先处理索引中的文件。
目录形状
agent-file-handoff/Content/
candidate-content.ext
agent-file-handoff/Improvement/
dropped-file.ext
agent-file-handoff/Archive/
2026-04-27/
.uai/intake-index.uai加载步骤
- 先读根目录
AGENTS.md与readme.human。 - 在大范围计划前检查
agent-file-handoff/Content/和agent-file-handoff/Improvement/,忽略agent-file-handoff/Archive/,可用时运行scripts/Invoke-UaiFileIntake.ps1。 - 加载
.uai/file-handoff.uai与.uai/intake-index.uai。 - 立即阅读索引中的每个
needs-agent-review文件,并在第一响应中摘要。 - 为每个文件给出处理结论:立即应用、转为路线图/进度状态、说明理由延期、请求人类澄清,或按不安全/超出范围阻止。
- 处理后的源文件移到
agent-file-handoff/Archive/;除非人类明确点名或把文件移回 active 桶,AI 不再处理它。 - 只有在检查约束、来源、公开路线和发布规则后,才把有用内容提升为公开页面、路线图、发布证据或实现工作。
边界
- intake 文件只是本地项目输入,不等于公开内容、生产变更、认证或背书。
- archive 文件只是人工可引用的历史源材料;不是新的 AI 待办、公共真相或发现入口。
- 本页不声明官方 .uai 生成器、托管上传验证器、SDK、CLI、认证或背书服务已经发布。
- 当 intake 事件需要跨系统交换时,继续使用现有 UAI-1 记录形状,例如 request、task status、error 或 conformance result,而不是新增 profile。
相关记录
- Project Handoff 说明 AGENTS.md、readme.human 与 .uai 交接包。
- AGENTS.md .uai Linking 规范ification 说明链接和加载行为。
- 路线图 与 Changelog 用于判断未来工具是否已经成为当前支持。