该技能用于 SEED 设计系统中组件文档的编写与维护,核心思路是把“一个组件的文档”拆成几层分别处理:公共指南、Figma 页面、平台文档。请求到来时先判断要改哪一层,再只读取对应的参考文件。
主要能力与产物对应关系:
-
公共指南 MDX:写入 docs/content/components/<id>.mdx,参考 guide-doc.md,输入为组件角色、部件、属性、使用规则的依据(Figma 页面、实现、PRD、用户说明)。
-
Figma SEED-Docs 页面:参考 figma-doc.md,输入为指南 MDX 或同内容草稿,以及目标文件与页面。
-
既有 Figma 页面迁移为指南 MDX:参考 figma-migration.md 与 guide-doc.md,输入为 Figma 节点 URL。
-
React 与 Lynx 文档:写入 docs/content/{react,lynx}/components/<name>.mdx,参考 platform-doc.md,输入为实现源码、Registry snippet 与示例文件。
使用方式:当同时被要求写指南和 Figma 页面时,先确定指南 MDX 正文,再把该文本搬到 Figma,不分别撰写两处句子。Figma 原始文件(SEED-Docs)中已有页面仅在用户指定的页面或分支上修改;调用 use_figma 前需先阅读 figma-use 技能。文档改动的验证为内容、链接与格式检查,docs 构建检查按 docs/AGENTS.md 的“验证”执行。
边界与限制:文档工作不改变组件实现、Recipe 与 Registry;文档写作中发现 API 或行为问题,应拆分为对 seed-component 既有实现的修改,而不是在文档里写绕行方案。示例文件的编写与运行、Registry 发布路径、Lynx 兼容性 frontmatter 与设备验证不由本技能承担,属于 seed-component 的 lynx-docs.md、lynx-docs-authoring.md、implementation-steps.md;platform-doc.md 只负责文字与结构。