用途:为代码智能体编写仓库根目录的 AGENTS.md,让智能体知道设计系统各部分所在位置、适用哪些规则及规则来源、如何自查、不应做什么。智能体进入代码库时会先读 AGENTS.md、CLAUDE.md、.cursor/rules/、.github/copilot-instructions.md 等约定文件,本技能确保设计系统知识能被智能体看到。
主要能力:使用前需校验 frontmatter 中 references 路径是否相对 SKILL.md 存在;若缺失应停止,提示用户按 1-INSTALL.md 重装并运行 verify-install.sh,除非用户明确要求继续。先盘点可指向的对象:已有指令文件、本套件产出的机器可读文件(.ai/index/、.ai/metadata/、决策树页面、token 文件)、系统本身(组件源码与导出、token 源与消费方式、文档站或 Storybook URL、CONTRIBUTING.md、CHANGELOG.md)、已存在的强制检查(ESLint、Stylelint、package.json 脚本、CI 工作流)、书面规则。每条规则须在方括号中标注来源(文件路径、URL、决策记录 id 或 team);无来源的规则列入“Proposed, not yet policy”清单。AGENTS.md 控制在约 150 行以内,结构包括系统名、待确认项、What this is、Where things live、Use these not those、Rules、Accessibility、Check your work、Don't、Proposed 等。只在被要求时写入口指针文件(CLAUDE.md、.cursor/rules/design-system.mdc、.github/copilot-instructions.md),内容为一行“读 AGENTS.md”,不复制正文;已有内容则追加而非替换。
边界:本技能只写指令,不构建清单、逐组件元数据、token 文档或选择页;若系统尚无组件、token 或文档可指向,则没有可指示的内容。若存在 .ds-ops-config.yml,需遵循相关配置知识笔记,读取 system.name 等字段及 agent_instructions.path、agent_instructions.pointers。
限制:不编造合同或规则;某节无内容时写诚实的说明而非虚构;检查命令必须真实存在于 package.json。官方未提供其他收费、价格或平台信息。