一个交接包,多个代理表面。UAIX 项目交接 在存储库本地文件中保留持久的项目内存,以便 Codex、Claude Code、Cursor、GitHub Copilot、Gemini Code Assist、本地代理、供应商和人员可以在工作开始之前加载相同的当前状态。
这是实用的兼容性指南。它没有宣布这些产品的官方 UAIX 适配器,也没有将特定于工具的指针文件转变为新的事实来源。
当前支撑边界
- 支持的模式是本地存储库内存:
AGENTS.md、.uai/readme.human、键入的.uai记录以及选择的agent-file-handoff/摄入文件夹。 - 特定于工具的文件可以指向该捆绑包,但它们应该保持精简,并且不应重复政策、支持声明、路线图状态或项目真相。
- 这些映射是兼容性模式,而不是官方适配器、认证集成、SDK、CLI、托管导入验证器、自动存储库编写器或认可声明。
- 代理运行时可以执行任务、请求批准、调用工具或生成跟踪。项目切换保留项目内存和审查边界。
代码范围设置规则
没有 .uai/coding-standards.uai 就无法编码。项目/开发人员包还需要 .uai/coding-standards.uai、.uai/architecture.uai 和 .uai/next-recursive-prompt.uai。当人类要求更新 architecture.uai 和 coding-standards.uai 时,接收代理必须首先深入研究代码库,从代码库推断适用的语言和框架,并在编辑这些文件之前从可见的源证据中导出架构、约定、测试姿势和标准。
成熟的项目应该被视为已经固执己见的系统:保留现有的本地模式,除非有明确的证据、业主指示或测试证明改变是合理的。新项目或新建项目可以依赖行业默认值,但这些默认值必须标记为推断的设置指南,而不是观察到的项目真相。
工具映射
| 表面 | 最佳本地参赛作品 | 保持纤薄 |
|---|---|---|
| 法典 | 根AGENTS.md,.uai/readme.human,加载的.uai文件,以及选择的repo技能.agents/skills/uaix-handoff/。 |
使用 AGENTS.md 作为前门,并将技能作为工作流程指导,而不是项目真相。 |
| 克劳德·科德 | 导入或重定向到 AGENTS.md 的根 CLAUDE.md 指针。 |
让克劳德特定的文件说明从哪里开始;将约束和状态保留在共享切换包中。 |
| 光标 | 最小的游标规则或项目注释,表示读取 AGENTS.md,然后读取 .uai/readme.human,然后读取列出的 .uai 文件。 |
当相同规则属于 AGENTS.md 或 .uai/constraints.uai 时,避免将长规则复制到游标设置中。 |
| GitHub 副驾驶 | 当存储库需要 Copilot 存储库指令时,.github/copilot-instructions.md 作为短指针。 |
仅将副驾驶文件用于交接接载订单和安全提醒;将持久项目状态保留在 .uai 中。 |
| Gemini 代码协助 | 根 GEMINI.md 或等效的工作区指令指针(当对该存储库有用时)。 |
将 Gemini 特定的措辞限制为如何加载共享包和报告检查。 |
| 其他当地代理 | 从 AGENTS.md 开始,仅解析存储库本地 @uai[] 引用。 |
阻止父目录转义、可执行文件摄入、隐藏生成的包含以及不受支持的支持声明。 |
在仓库中采用它
- 创建根
AGENTS.md作为规范的面向代理的前门。 - 创建
.uai/readme.human以获得人类可读的切换解释。 - 为上下文、堆栈、约束、决策、进度、操作和测试计划指导创建类型化
.uai/记录。 - 对于 Visual Studio 解决方案,请将
.uai/保留在实际的.sln或.slnx旁边,将每个生成的.uai文件注册为解决方案项,并在报告成功之前验证存在的解决方案引用文件。 - 当删除文件接收是工作流程的一部分时,添加
agent-file-handoff/Content/和agent-file-handoff/Improvement/;当配置的持久内存存储已存在时,请勿添加源站点存档存储桶。 - 仅当工具受益时才添加特定于工具的指针文件,并使每个指针都指向
AGENTS.md。 - 对更改的切换表面运行有针对性的本地检查并记录剩余的阻止程序,而无需声明验证器支持的一致性。
请勿索赔
- 请勿仅从该模式中获得官方 UAIX 认证、UAI-1 一致性、验证器支持的移交合规性或供应商认可。
- 除非存在公共工具和证据,否则请勿声明托管
.uai上传/导入验证、自动存储库写入、自动 LLM Wiki 同步、SDK、CLI 或官方适配器支持。 - 请勿将机密、凭据、原始客户数据、特权操作、隐藏提示或仅限生产的详细信息放入便携式移交文件中。
- 不要仅仅为了使代理文件交接可见而添加 CI 拾取、计划作业、观察程序、守护程序、队列文件夹或始终在线的服务。
可复制的取件提示
You are working in this repository.
1. Read AGENTS.md first.
2. Read .uai/readme.human as briefing context.
3. Load every @uai[] file listed in AGENTS.md.
4. Inspect active agent-file-handoff/Content/ and agent-file-handoff/Improvement/ intake before broad work.
5. Summarize current project truth, hard constraints, expected touchpoints, and targeted checks before editing.
6. Do not claim certification, conformance, official adapter support, automatic writes, hosted import, SDK, CLI, or endorsement unless repo evidence proves it.
7. Do not place secrets, credentials, private data, or production-only details into handoff files.这与 OpenAI 指南有何关系
使用OpenAI 和 Codex 指南当任务以 OpenAI 代理、Codex、技能、MCP、会话、跟踪、批准或运行时切换为中心时。当存储库需要相同的切换包在多个编码代理表面上工作而无需为每个工具发明单独的事实时,请使用此页面。
相关 UAIX 记录
- 项目交接主要的 AGENTS.md、 .uai/readme.human 和 .uai 模式。
- OpenAI / Codex 指南OpenAI 运行代理;项目切换保留项目内存。
- AGENTS.md .uai 链接规范链接语法和加载器行为。
- 代理文件交接聊天开始时接收已删除的本地文件。
- 人工智能记忆更广泛的便携式内存框架和入门包。
- 路线图当前与计划的适配器、验证器、SDK、CLI、认证和认可边界。
- 变更日志注明日期的公共变更记录。
承载长期目标的代码
对于代码承载的长期运行目标,将编码代理切换与长期目标执行并仅在权威回写和最终证据后重新生成 .uai/next-recursive-prompt.uai 。