القائمة
盘活项目中的存量业务组件，让 AI 认识它们。脚本扫描组件清单 + Props，AI 补充语义描述。触发词：组件文档、AI组件文档、盘活组件、提取组件API、component docs for AI。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Trigger when the user requests a review of frontend files (e.g., `.tsx`, `.ts`, `.js`). Support both pending-change reviews and focused file reviews while applying the checklist rules.
从 Vue 3 页面组件中提取框架无关的产品文档(Markdown)，用于跨框架迁移和新人快速上手。支持场景：查询列表(query-list)、表单(form)、详情页(detail-page)、审批流(approval-flow)、整模块(module)。触发词：提取文档、提取产品文档、vue文档提取、extract vue doc、页面文档、模块文档提取。
生产者视角商业分析助手。把任何产品/服务/生意从消费端翻转到生产端，拆解成本结构、定价逻辑、利润模型和竞争壁垒。核心能力：单品成本拆解、商业模式分析、产业链扫描、个人机会判断。触发词：分析一下、怎么赚钱、为什么这么贵、生意拆解、成本分析、生产视角、这行业、能赚多少、利润在哪、定价逻辑、供应链、值不值这个价、能不能做、生意好吗、商业模式、选品逻辑。
架构对抗顾问与高级技术思维搭档。用真实行业案例挑战设计方案，用外部知识拓宽架构视野，针对具体情况给出辅导建议。触发场景：当用户提到 '架构评审'、'架构挑战'、'红队审查'、'技术方案评审'、'系统设计评审'、'架构诊断'、'方案挑战'、'架构讨论'、'帮我看看架构'、'系统设计'、'技术选型'、'challenge my architecture'、'review my design'、'architecture review'、'design critique'、'evaluate my architecture'，或要求对系统架构、数据库选型、微服务拓扑、扩展策略、基础设施决策进行批判性评估时触发。本技能将 AI 从一个只会附和的工具，变成能带来外部行业知识的严肃思维搭档。
Use when updating, clarifying, or iterating on an existing PRD document. Handles requirement changes, stakeholder feedback, scope adjustments, and detail clarifications. Complements write-prd (which creates new PRDs). Do NOT use for initial PRD creation.
Use when writing PRD documents, translating user ideas into structured requirements, or analyzing product requirements. Do NOT use when writing code.
| name | component-ai-docs |
| description | 盘活项目中的存量业务组件，让 AI 认识它们。脚本扫描组件清单 + Props，AI 补充语义描述。触发词：组件文档、AI组件文档、盘活组件、提取组件API、component docs for AI。 |
让 AI 认识你项目里的业务组件——接受什么 Props、什么时候用、什么时候不用。
[待确认]，AI 读不懂也标注 [待确认]。不强求全覆盖。运行脚本扫描项目中的业务组件：
node <skill-dir>/scripts/scan-components.mjs <项目根目录>
可选参数：
--dir <path> — 只扫描指定子目录--output <path> — 自定义输出路径产出：.ai/project-components/.component-list.json
脚本做的事（有边界）：
interface XxxProps 字段和类型[待确认]脚本输出 "No component files matched" → 告知用户，询问 --dir 路径后重试。
组件数 > 30 → 告知用户建议缩小范围，询问是否继续。
读取 .component-list.json，展示：
组件清单（共 15 个）：
=== 高优先级（>= 5 次引用）===
⬜ UserSelector — 12 次引用，Props: 5 个字段(1 个待确认)
⬜ StatusTag — 8 次引用，Props: 3 个字段
=== 中优先级（2-4 次引用）===
⬜ DeptTree — 3 次引用，Props: 4 个字段
⬜ FileUploader — 2 次引用，Props: 未找到
=== 低优先级（< 2 次引用）===
⬜ DataCard — 1 次引用，Props: 6 个字段(2 个待确认)
...
Props 提取概况: 素材 available: N/M, 素材 partial: N/M, 素材 missing: N/M.
询问用户：选择优先级：高 / 中 / 低？
一次处理一个组件，填 @FILL 标记后写入文件。每完成 5 个暂停，汇报摘要等待用户确认。
读取 .component-list.json 中该组件的条目，含 props、usageExamples。
如果 usageExamples 非空，用 Read 读取第一个使用示例文件，定位该组件的 JSX 使用片段（约 10 行）。
@FILL:VALUE component_summary [P0]
提示: 一句话描述该组件的功能。从组件名 + Props + 使用示例推断。
@FILL:TABLE props_table [P0]
提示: 从 .component-list.json 中取 props 字段。对每个 prop 补充「用途说明」列。
列: 参数名 | 类型 | 必填 | 用途说明
@FILL:BLOCK usage_snippet [P1]
提示: 从 usageExamples 第一个文件中提取该组件的 JSX 使用片段（~10 行，代码块格式）
@FILL:VALUE use_when [P0]
提示: 用一句业务语言描述何时使用该组件，基于 Props + 使用场景推断。不确定则写"[? 待确认] 需人工补充"
@FILL:VALUE dont_use_when [P1]
提示: 反推何时不该用。无明确排除场景则写"暂未发现排除场景"
@FILL:VALUE prefer [P2]
提示: 同目录下有无类似组件可作为替代。无则写"暂未发现替代方案"
填充规范：
[待确认]，不猜测[待确认] 的复杂类型，AI 阅读源码后尝试补充，仍无法确定则保留 [待确认]use_when / dont_use_when / prefer 默认标注 [? 待确认]，引导开发者在 metadata.json 中修正按 references/output-format.md 模板生成以下文件：
.ai/project-components/components/<组件id>/index.md.ai/project-components/components/<组件id>/metadata.json写入后 Read 验证文件非空。
每 5 个组件暂停一次：
完成第 1-5 个组件：
1. UserSelector — useWhen: "表单中选择用户，支持按部门筛选" [? 待确认]
dontUseWhen: "单选用户且不需要部门筛选 → 可直接用 Select" [? 待确认]
2. StatusTag — useWhen: "渲染状态枚举列，支持 dictKey" [? 待确认]
...
以上需要修改吗？输入序号+修改内容，或输入"继续"。
| 文件 | 内容 | 何时读 |
|---|---|---|
references/output-format.md | 目录结构、index.md 模板、metadata.json 规范 | Step 3c 写入时 |
references/jsdoc-guidelines.md | Props 注释写法规范 | Step 3b 填 props_table 时 |
[待确认] 的字段，由 AI 在 Step 3b 尝试补充useWhen / dontUseWhen 最终只有开发者能写对——AI 产出的是初稿，需人工审核