指南

此处说明当前公开记录、证据路径和支持边界。

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-DOC-0414
  • 路径 /zh-cn/guides/project-handoff-coding-agents/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-DOC-0414
表面
指南
使用权
公开且可链接

如何使用本页

使用本指南可以让 Codex、Claude Code、Cursor、GitHub Copilot、Gemini Code Assist、本地代理、供应商和人员指向同一个存储库本地项目 Handoff 包,而无需声明官方适配器。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

在旁边使用

项目交接OpenAI / Codex 指南上下文预算指南代理文件交接

跨代理切换

用于多个编码代理表面的一个本地包

Point Codex、Claude Code、Cursor、GitHub Copilot、Gemini Code Assist、本地代理、供应商和 AGENTS.md、 .uai/readme.human 和 .uai 文件中的人员,无需将指针文件转换为官方适配器。

前门

AGENTS.md 保持规范

特定于工具的文件应该是微小的重定向回共享切换包,这样约束和当前状态就不会漂移。

记录

.uai 文件携带类型化状态

上下文、堆栈、约束、进度、决策、操作和测试计划记录使持久项目内存保持可检查性。

所需标准

如果没有所需的代码范围文件,则无需编码

项目/开发人员包还需要 .uai/coding-standards .uai。与编程相关的代理必须按照要求的设置对待编码标准、architecture .uai 和 next-recursive-prompt .uai。他们必须从可见的代码库、清单、测试、CI、部署文件、路由、架构和所有者指令中推断适用的语言/框架/数据/API/安全配置文件,保留最佳的现有本地模式,强制执行 DRY、一次且仅一次、SOLID 和自动化测试,将递归提示仅视为派生热内存,将其用于延续或直接相关的请求,枚举相关的活动 Agent File Handoff 摄入量,因为摄入量会取代或扩展存储的循环,并且当无法建立标准、架构证据、下一个循环证据、摄入证据或检查时停止。

边界

兼容性不是认证

这些是实用的拾取模式,而不是官方适配器、SDK、CLI、托管导入验证器或背书声明。

在旁边使用

项目交接主要 AGENTS.md、 .uai/readme.human 和 .uai 模式。OpenAI / Codex 指南OpenAI 运行时边界和回写模式。上下文预算指南防止一个共享包成为一个共享存档。代理文件交接丢弃的文件的接收和处置。路线图当前和计划的工具边界。
取件提示共享本地切换开始
Read AGENTS.md first, then .uai/readme.human, then the listed .uai files. For code work, read or create .uai/coding-standards.uai, infer the applicable language/framework profiles from the codebase, preserve good local patterns, keep .uai/next-recursive-prompt.uai as derived hot-memory for continuation or directly related requests, and map automated tests before editing. Summarize current truth, constraints, expected touchpoints, and targeted checks before editing.

当工具不会自动选择 AGENTS.md 时,请在特定于工具的指针中使用此形状。

一个交接包,多个代理表面。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.uaicoding-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[] 引用。 阻止父目录转义、可执行文件摄入、隐藏生成的包含以及不受支持的支持声明。

在仓库中采用它

  1. 创建根 AGENTS.md 作为规范的面向代理的前门。
  2. 创建 .uai/readme.human 以获得人类可读的切换解释。
  3. 为上下文、堆栈、约束、决策、进度、操作和测试计划指导创建类型化 .uai/ 记录。
  4. 对于 Visual Studio 解决方案,请将 .uai/ 保留在实际的 .sln.slnx 旁边,将每个生成的 .uai 文件注册为解决方案项,并在报告成功之前验证存在的解决方案引用文件。
  5. 当删除文件接收是工作流程的一部分时,添加 agent-file-handoff/Content/agent-file-handoff/Improvement/ ;当配置的持久内存存储已存在时,请勿添加源站点存档存储桶。
  6. 仅当工具受益时才添加特定于工具的指针文件,并使每个指针都指向 AGENTS.md
  7. 对更改的切换表面运行有针对性的本地检查并记录剩余的阻止程序,而无需声明验证器支持的一致性。

请勿索赔

  • 请勿仅从该模式中获得官方 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 记录

承载长期目标的代码

对于代码承载的长期运行目标,将编码代理切换与长期目标执行并仅在权威回写和最终证据后重新生成 .uai/next-recursive-prompt.uai