用途：xy-toolchain 是 Aries Tools TypeScript 工具链（@ariestools/toolchain）的技能文档，面向 XY、XYO、XL1 仓库，指导使用稳定的 xy 与实验性的 xyex 命令行工具、xy.config.ts 及相关配置。该技能仅在 ariestools/ariestools-skills 维护，其他位置的副本为跳转占位。
主要能力：覆盖项目画像识别（库、CLI、服务、应用、工作区根、工具等角色与可见性、运行时、框架）、工具链与项目初始化（pnpm、pnpm-workspace.yaml、根脚本、xy repo init、从 @xylabs/* 迁移、9.x 升 10.x）、编译与包输出（xy.config.ts、neutral/node/browser 目标、library/bundle/transpile/monolith/vendor 模式、类型校验）、命令与策略目录（build、check、fix、test 等生命周期与 CI 门禁，deplint、api-exposure、publint、license、secure 等检查，xy agent、xy skills、deploy、publish、install、up、updo 等）、计划工具、ESLint 配置、TypeScript 配置、Vitest 测试等。
使用方式：先检查仓库的 package.json、锁文件、xy.config.ts、ESLint/TypeScript/测试配置，优先使用仓库已有脚本，无更窄封装时再用 xy CLI。xy 为语义化稳定版；xyex（自 9.2.0）为实验性超集，命令、标志与配置可能在小版本变更，实验性命令如 work、dead、plan 建议用 pnpm xyex <cmd> 运行。可用 pnpm list @ariestools/toolchain --depth 0 查看已安装版本（pnpm xy --version 自 10.0.6 起可靠）。本技能针对 @ariestools/toolchain 10.1.5 验证，未标注“(since X)”的内容自 9.0.0 起存在。
限制：缺失的顶层命令会打印 Command not found，10.1.2 起退出码为 1，10.1.1 及更早可能为 0；缺失子命令可能被静默忽略或被当作包目标，需检查输出与版本说明而非仅看退出码。不要在新工作中安装已退役的 @xylabs/* 兼容名。相关技能（xy-development、ariestools-sdk、ariestools-sdk-react、ariestools-actor、xy-agent、xy-product-plan）为导航链接，各自独立安装。其余细节暂未提供。