用途:为加入使用某设计系统的团队的设计师或工程师撰写入职指南。指南含共同核心与按角色(设计师、工程师或两者)分设的章节,事实来自代码仓库、Figma 库或团队本身;其余内容标记为 [confirm: …] 并列在开头,以免发布未经核实的猜测。
主要能力:先读后问。从 .ds-ops-config.yml、package.json、令牌来源或构建产物、导出的 TypeScript 类型、测试设置、CONTRIBUTING.md、CHANGELOG.md、Storybook 或文档站点,以及 Figma(库页面名、变量集合与模式、组件集名)收集事实;再向团队询问读者角色、联系人、贡献路径、无障碍标准、更新频率、包装器规则、库更新推送或拉取方式、已知薄弱处。已有指南则更新而非重写。
使用方式:按固定顺序撰写:标题与元信息(读者、更新日期、联系方式、待确认项)、共同核心(系统是什么、工作方式、前两周清单、常见问题)、设计师章节(Figma 设置、文档、交付、常见错误)、工程师章节(安装与渲染、组件用法、令牌用法、测试、常见错误)、速查表。少于五个组件的项目有简化说明。示例用检测到的技术栈与真实包名、导出、令牌名书写。
限制:所有安装命令、导入路径、令牌名、库名和 URL 必须来自仓库、Figma 或团队,不得杜撰;策略性内容(更新频率、包装器规则、无障碍保证)须来自团队或标为 [confirm];不得以良好实践冒充团队策略;不测试真实组件而改用 mock 的做法应被劝阻。参考资料路径缺失时应停止并提示重新安装,除非用户明确要求继续。具体团队、渠道、人名等事实暂未提供。