用途：xy-agent 定义仓库如何向 AI 智能体说明“什么是真的”。它规定一个入口文件 AGENTS.md、各工具的精简适配文件（如 CLAUDE.md、copilot-instructions），以及按生命周期而非主题划分的文档树，让文档的年龄、权威性和是否被替代无需打开即可判断。
主要能力：涵盖仓库结构（规范目录树、papers/ 与 specs/ 与 docs/ 的划分、生命周期子目录、不可变源归档）；AGENTS.md 入口（必需章节、权威表的状态列、体积预算、@AGENTS.md 导入、.claude/rules/ 路径作用域、嵌套包文件）；文档生命周期（front-matter 模式、状态词汇、决策记录、带日期的证据文档、生成的索引、归档流程）；审计与维护（检查目录、陈旧与孤立文档检测、发现如何转为 xy 工作项、当前工具状态）；以及各类模板。
使用方式：先阅读目标仓库自身的 AGENTS.md，它对该仓库具有权威性；本技能只描述这些文件应有的形态，不覆盖具体仓库的自我说明。在陌生仓库定位、决定新文档归属、或为尚无此模式的仓库搭建时，先读“仓库结构”；编写或精简 AGENTS.md、接入适配文件时读“AGENTS.md 入口”；新增文档、变更状态、替代或归档时读“文档生命周期”；被要求审计文档或发现文档与代码不符时读“审计与维护”；创建约定描述的文件时使用“模板”。
适用场景：需要让智能体可靠理解仓库约定的项目，尤其是文档易失真的多工具协作仓库。
限制：本技能建立在 Development Skill 之上，属推荐而非必需；不遵循该模式的仓库不算缺陷，应沿用其既有约定，不要在任务中途强行转换。本技能仅在 ariestools/ariestools-skills 维护，XYOracleNetwork/xyo-skills 下的副本为跳转占位，不应在那里编辑。相关技能包括 xy-development 与 xy-toolchain（含用于跟踪文档维护的 xy work）。