메뉴
Create, modify, or remove admin UI pages for the Cat project. Use when adding/editing/removing admin pages, admin list/detail views, admin management features, or when the user mentions admin UI, admin frontend, 管理端界面.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | manage-ui-admin |
| description | Create, modify, or remove admin UI pages for the Cat project. Use when adding/editing/removing admin pages, admin list/detail views, admin management features, or when the user mentions admin UI, admin frontend, 管理端界面. |
管理端界面位于 web/src/admin/，使用 React + MUI + React Query。入口为 web/admin.html，路由 basename 为 /web/admin。
新增页面 — 5 步（下文详述）：
Task Progress:
- [ ] Step 1: API 层 — 在 web/src/admin/api/ 中封装后端调用
- [ ] Step 2: 页面组件 — 新建列表页 / 详情页
- [ ] Step 3: 路由注册 — 在 routes.jsx 中添加 Route
- [ ] Step 4: 侧边栏导航 — 在 AdminLayout.jsx 的 MENU_ITEMS 中添加菜单项
- [ ] Step 5: 更新 docs/prds/{domain}/features/{feature}.md 的 `## ui_admin`
修改页面 — 按 references 扩展对应文件；queryKey / 筛选字段变动时同步 invalidateQueries；需要新 admin endpoint 时先走 manage-api-admin。对于存在删除、恢复、启停、审核等重复操作的列表页，默认优先考虑加入多选和批量操作入口；如果后端没有批量接口，前端可在确认后循环触发单条接口。列表页如果有 tab，tab 必须有对应 URL，不能只用组件内 useState 切换。
删除页面 — 反向 5 步：PRD → 菜单 → 路由 → 页面组件 → API（确认无其他引用再删）。
在 web/src/admin/api/<context>.js 中封装 API 调用。模式详见 references/api-layer.md。
在 web/src/admin/routes.jsx 的 Route element={<AdminLayout />} 内添加路由。详见 references/routes-nav.md。
在 web/src/admin/components/AdminLayout.jsx 的 MENU_ITEMS 中添加菜单项。详见 references/routes-nav.md。
在 docs/prds/{domain}/features/{feature}.md 的 ## ui_admin 小节中记录管理端页面、列表 / 详情 / 编辑 / 审核交互、筛选项、批量操作和状态展示。PRD 已按 domain + feature 分层，不再创建或更新 docs/prds/{domain}/ui_admin.md 这种 aspect 文件。
选择 feature 的规则：
docs/prds/{domain}/overview.md 的 Feature 列表和 features/ 下已有文档。## ui_admin。manage-prd 的规则创建 / 更新 feature，并同步 overview.md 的 Feature 列表。manage-api-admin 完成 API 与同一 feature 的 ## api_admin 更新。生成、解释和修改 Cat 项目的 `priv/config/catalog_schema.yaml`。当任务涉及 Catalog schema、Class / Property 定义、ClassProperty 绑定、Property.constraint、Class.subject_page_layout、claim_display、subject_explore_config，或需要为新领域生成可同步的 Catalog YAML 时使用。
解释、生成和修改 Cat 项目的 `priv/config/class_ingestors_schema.yaml`。当任务涉及 class ingestor 的概念、YAML 语法，或 `steam`、`wikidata` 的 provider 配置时使用。手动调用触发。
使用 Cat 项目的 `mix cat.api_admin` 命令完成管理端操作任务。用于读取 `openapi/admin_openapi.yaml` 查找管理端接口，并调用管理端 API 查询列表、查看详情或执行管理端写操作。手动调用触发。
新增或修改 Cat 项目的管理端 API（`/api/admin/<context>/<action>`）。用于 `api_admin` 计划层、admin 列表/详情/写操作的后端实现。
Add and manage user-facing API endpoints in the Cat project using the CatApiSpec DSL. Use for the `api` plan layer, frontend/public APIs, schemas, generated request modules, and routes. For `/api/admin/...` endpoints use `manage-api-admin`.
创建和维护 Cat 项目的 PRD。用于按 domain 总览 + 粗粒度 feature 文档组织 docs/prds，包括 docs/prds/{domain}/overview.md、data_model.md、features/{feature_title}.md；也用于判断 feature 粒度、迁移旧版 aspect PRD，或生成可按 feature 复制到其他系统的产品规格。