figma-spec-search 是一个可复用的 AI Agent Skill，用于在大型 Figma Design Page 中检索文字、说明、模块、状态和设计依据，并返回可点击的原始节点链接。
它不绑定具体产品或业务。可以用于查找交互规则、文案、流程步骤、错误状态、设计决策、验收说明等内容。
Skill 每次使用前只读取本地更新状态。距上次成功检查超过七天时，才通过 scripts/check_update.py 读取官方 GitHub 仓库中的 update-manifest.json：
required：必更版本，先更新再执行任务；recommended：以当前本地版本能否完成用户任务为准；本地能力足够时不更新，只有新能力正好解决当前问题时才更新；- 无法联网检查：默认继续使用本地版本，不把网络失败误判为必更。
网络检查失败后 24 小时内不重复尝试。没有 Python 3 时，Agent 使用平台状态存储执行相同逻辑；无法持久化时，每个新会话最多检查一次。
发布新版本时同时更新 version、update_policy、minimum_supported_version、changes 和 capabilities_added。是否必更由 update_policy 决定，不与 major/minor/patch 强绑定。设置为 required 时必须填写 required_reason。
如果由 Agent 发布，Agent 必须先询问并确认上述字段；没有明确选择 required 或 recommended 时不得发布。
- 画布上手动创建的文字；
- 说明、标注和注释组件，以及说明实际指向的目标；
- 目标 Case/Frame 上方的手动标题、标题条和模块标题；
- Case、Frame、Section 名称及相邻状态；
- 获得用户许可后，才读取指定 Frame 的细分图层。
默认不展开大型 Frame，因为子图层可能很多、读取速度慢，而且有效信息不一定更多。
提供：
- 一个或多个 Figma Design 链接；
- 想查询的问题或关键词；
- 已知的相关节点或截图（如果有）；
- 希望的输出形式。
示例：
使用 figma-spec-search 搜索下面的 Figma Page。
我想查询：
1. 表单校验的触发条件；
2. 错误提示文案；
3. 提交成功后的状态。
检索顺序、指向关系判断、性能控制和未找到项的处理方式已经包含在 Skill 中，无需在提示词里重复声明。
- 搜索到什么，就清楚说明什么；
- 直接文字和推断分开标记；
- 未找到项保持简短；
- 模块和细节点都尽量提供 Figma 链接；
- 不把“轻量检索未找到”扩大成“设计稿不存在相关内容”。
- Figma MCP，或其他能够提供
use_figma能力的兼容连接； figma-useSkill；- 对目标 Figma 文件的读取权限；
- 当前 Agent 或工具支持安装
SKILL.md格式的 Skill。
Skill 会先执行最小只读预检，并区分文件访问权限、内部 DevMode Editor 权限和 MCP 配置问题。识别到缺失权限后，会先说明准备申请的具体权限、原因和范围，得到用户确认后才发起申请。
在 ByteDance 内部环境中，如果缺少 DevMode Editor 权限，AI 会优先提供 IT 软件中心直达入口，并附上权限申请文档。当前 Agent 无法自动申请时，会把两个链接、已确认字段和原任务整理成交接指令，交给 Founder Studio Agent 完成；权限生效后再回到原查询继续执行。
权限错误不会被误写成“设计稿中没有相关内容”。
把下面这段话直接发给需要使用该 Skill 的 AI：
请安装并启用 GitHub 仓库中的 `figma-spec-search` Skill：
https://github.com/zicator/figma-spec-search
请自行识别当前 Agent 或工具支持的 Skill 安装方式与目录，优先克隆仓库；如果不适合克隆，请下载 GitHub 自动生成的最新版压缩包：
https://github.com/zicator/figma-spec-search/archive/refs/heads/main.zip
安装后请自行验证：
1. Skill 根目录包含 `SKILL.md`；
2. Skill 根目录包含有效的 `update-manifest.json`；
3. 当前环境能够发现并调用 `figma-spec-search`；
4. Figma MCP 能够提供 `use_figma`；
5. `figma-use` Skill 可用；
6. 当前账号可以读取目标 Figma 文件。
如平台需要重载 Agent、刷新 Skill 列表或开始新会话才能生效，请完成该操作；如果无法代为完成，请只告诉我所需的最小操作。
只有遇到权限不足、平台不兼容或缺少依赖时才请求我介入，并明确说明具体阻塞。不要默认让我手动下载、解压或寻找安装目录。
AI 应优先自行完成下载、安装、启用和验证。不同工具的 Skill 目录和刷新机制可能不同，因此不在本文中固化某个平台的路径。
如果当前工具尚不支持 SKILL.md，AI 应说明不兼容点，并根据该工具支持的扩展机制给出最接近的接入方案；不要声称已经成功安装。