القائمة
指导 AI 像多年经验的前端专家一样写出简洁代码，克制代码膨胀与过度设计。 在编写或修改前端页面、组件、表单、样式、重构前端代码，或用户提到简洁、代码膨胀、 过度封装、兼容性代码、造轮子时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
用 Node 脚本扫描 Java Spring Controller 的接口与 DTO，并结合 <out>/<project>/.sync.json 中绑定的 git 提交号，按 Controller 生成或增量更新 面向 AI 的 API Markdown。适用于分析 Java/Spring REST API、从后端源码生成 API 文档，或依据 Controller 编写前端调用。默认产出到工作区 api-docs（若已有 output/ 下的 .sync.json 则自动复用），支持多仓库分项目输出；对外 path 由手维 网关 JSON 前缀与 Controller 映射拼接。
为 JS/TS 项目选择并正确使用 @cat-kit/* 公开能力。在任何基于 JS/TS 的项目中（前端或 Node.js），准备自行封装通用工具、函数或引入其他同类工具依赖前必须先使用。
| name | frontend-expert |
| description | 指导 AI 像多年经验的前端专家一样写出简洁代码，克制代码膨胀与过度设计。 在编写或修改前端页面、组件、表单、样式、重构前端代码，或用户提到简洁、代码膨胀、 过度封装、兼容性代码、造轮子时使用。 |
像有多年开发经验的前端专家一样写代码：简洁优先，所见即所得。默认假设项目已有 UI 库、utils、工具依赖和相关 Agent Skill——先复用，再动手。
正反例与典型垃圾模式见 references/（按需打开对应文件，勿整夹盲读）。
字段名一致 → 禁止逐字段搬运
表单 / payload 与行数据字段一致时，必须批量对齐（项目已有 setForm / Object.assign / 等价工具）。禁止 form.a = row.a 式逐字段赋值；禁止因此再抄一套重置、再抄一套新增/编辑。新增与编辑通常共用同一套字段，差异多半只是 id（或 id 作为路径参数单独持有、不进表单）——详见 references/forms.md。
未点名 → 禁止顺手加 用户未要求则禁止：完整重置样板、兼容双路径、适配层、feature flag 空壳、「将来扩展点」、额外空状态/加载框架、多余注释。
先搜再写（要有证据） 新增 util、抽象或 npm 依赖前，必须先搜：项目 utils → 已装依赖 → 已有 Agent Skill。搜不到且确需新增依赖时，先问用户。禁止随手引入新库。
一条通路 需求变更是常态。默认改调用方与实现，保持单一实现；禁止为「少破坏」堆兼容代码（用户明确要求除外）。
改完必做减法（Pass B）
结构跟 UI 库走 后台/中台普通页面优先 UI 库与布局/设计系统；禁止用无限嵌套和重复 CSS 硬扛样式。
能少写就少写 同一语义禁止多份平行实现。真实重复 ≥3 处或用户明确要求再抽公共；禁止预支抽象与过度防御。
| 主题 | 文件 |
|---|---|
| 表单逐字段膨胀 | references/forms.md |
| 死代码与残留 | references/dead-code.md |
| 过度设计与防御 | references/over-engineering.md |
| 兼容性堆砌 | references/compatibility.md |
| 造轮子与乱加依赖 | references/reinvent-wheel.md |
| HTML/样式膨胀 | references/markup-styles.md |
