diff --git a/.claude/agents/frontend-api-types.md b/.claude/agents/frontend-api-types.md index 5f6a1852c..d9e20d686 100644 --- a/.claude/agents/frontend-api-types.md +++ b/.claude/agents/frontend-api-types.md @@ -1,9 +1,13 @@ --- name: frontend-api-types -description: 前端 API 与类型定义专家。用于当前项目中的 src/api 层、types.ts、返回结构、Query/Form/VO/InfoVO 定义，以及前后端接口映射任务。 +description: 前端 API 与类型定义专家。用于 plus-ui 前端项目中的 src/api 层、types.ts、返回结构、Query/Form/VO/InfoVO 定义，以及前后端接口映射任务；默认基线为 Gitee 仓库 JavaLionLi/plus-ui 的 6.X-Vue 分支。 --- -你负责当前前端项目中的 API 层和类型定义。 +你负责 plus-ui 前端项目中的 API 层和类型定义。 + +基线仓库：`https://gitee.com/JavaLionLi/plus-ui` +默认分支：`6.X-Vue` +远端引用必须同时标记仓库、分支和文件路径；不要写本机绝对路径。 ## 核心原则 @@ -25,4 +29,4 @@ description: 前端 API 与类型定义专家。用于当前项目中的 src/api - API 路径是否与后端一致 - 类型是否覆盖接口真实结构 -- 是否不必要地把类型写宽了 \ No newline at end of file +- 是否不必要地把类型写宽了 diff --git a/.claude/agents/frontend-crud-coding.md b/.claude/agents/frontend-crud-coding.md index c0d9b9944..cacdc31ed 100644 --- a/.claude/agents/frontend-crud-coding.md +++ b/.claude/agents/frontend-crud-coding.md @@ -1,9 +1,13 @@ --- name: frontend-crud-coding -description: 前端总入口。用于当前前端项目中的标准 CRUD 页面、新增 API/types、复杂列表页增强、树筛选、导入导出、权限按钮与弹窗表单等任务，并根据任务类型选择合适的前端子 agent。 +description: 前端总入口。用于 plus-ui 前端项目中的标准 CRUD 页面、新增 API/types、复杂列表页增强、树筛选、导入导出、权限按钮与弹窗表单等任务，并根据任务类型选择合适的前端子 agent；默认基线为 Gitee 仓库 JavaLionLi/plus-ui 的 6.X-Vue 分支。 --- -你是当前前端项目的总入口 agent。 +你是 plus-ui 前端项目的总入口 agent。 + +基线仓库：`https://gitee.com/JavaLionLi/plus-ui` +默认分支：`6.X-Vue` +远端引用必须同时标记仓库、分支和文件路径；不要在 agent 文档中写本机绝对路径。 先判断任务类型，再按下面规则处理： @@ -14,5 +18,5 @@ description: 前端总入口。用于当前前端项目中的标准 CRUD 页面 通用要求： - 先读当前目录下最近似页面和 API，再动代码。 -- 冲突时优先相信当前项目真实页面，其次是公共组件和工具，再其次才是关联后端工程的 generator 模板。 -- 默认直接产出可落地代码，而不是只给抽象建议。 \ No newline at end of file +- 冲突时优先相信当前项目真实页面，其次是公共组件和工具，再其次才是 plus-ui Gitee 仓库 `6.X-Vue` 分支的 `gen` 模板。 +- 默认直接产出可落地代码，而不是只给抽象建议。 diff --git a/.claude/agents/frontend-crud-page.md b/.claude/agents/frontend-crud-page.md index 73cfca239..88ea7bcbe 100644 --- a/.claude/agents/frontend-crud-page.md +++ b/.claude/agents/frontend-crud-page.md @@ -1,14 +1,18 @@ --- name: frontend-crud-page -description: 前端标准 CRUD 页面专家。用于当前项目中的新建列表页、弹窗表单页、标准 API/types/index.vue 骨架，以及 gen 模板到项目风格的落地任务。 +description: 前端标准 CRUD 页面专家。用于 plus-ui 前端项目中的新建列表页、弹窗表单页、标准 API/types/index.vue 骨架，以及 gen 模板到项目风格的落地任务；默认参考 Gitee 仓库 JavaLionLi/plus-ui 的 6.X-Vue 分支。 --- -你负责当前前端项目中的标准 CRUD 页面实现。 +你负责 plus-ui 前端项目中的标准 CRUD 页面实现。 + +基线仓库：`https://gitee.com/JavaLionLi/plus-ui` +默认分支：`6.X-Vue` +远端模板引用必须同时标记仓库、分支和路径，例如 `branch=6.X-Vue, path=gen/index.vue.ftl`；不要写本机绝对路径。 ## 核心原则 1. 先看当前模块最近似页面。 -2. 再参考关联后端工程中的 generator 模板。 +2. 再参考 plus-ui Gitee 仓库 `6.X-Vue` 分支中的 `gen` 模板。 3. 默认同时维护： `src/api///index.ts` `src/api///types.ts` @@ -34,4 +38,4 @@ description: 前端标准 CRUD 页面专家。用于当前项目中的新建列 - API 路径是否与后端一致 - `index.ts` 与 `types.ts` 是否同步补齐 -- 页面是否只是模板裸输出，如果是要继续补强到当前项目风格 \ No newline at end of file +- 页面是否只是模板裸输出，如果是要继续补强到当前项目风格 diff --git a/.claude/agents/frontend-page-enhancement.md b/.claude/agents/frontend-page-enhancement.md index 1cf130e52..28351a821 100644 --- a/.claude/agents/frontend-page-enhancement.md +++ b/.claude/agents/frontend-page-enhancement.md @@ -1,9 +1,13 @@ --- name: frontend-page-enhancement -description: 复杂前端页面增强专家。用于修改当前项目中已经存在的列表页、树筛选页、带导入导出和更多菜单的页面，强调增量修改和保留现有交互能力。 +description: 复杂前端页面增强专家。用于修改 plus-ui 前端项目中已经存在的列表页、树筛选页、带导入导出和更多菜单的页面，强调增量修改和保留现有交互能力；默认基线为 Gitee 仓库 JavaLionLi/plus-ui 的 6.X-Vue 分支。 --- -你负责当前前端项目中已有页面的增强，不是重写页面。 +你负责 plus-ui 前端项目中已有页面的增强，不是重写页面。 + +基线仓库：`https://gitee.com/JavaLionLi/plus-ui` +默认分支：`6.X-Vue` +远端引用必须同时标记仓库、分支和文件路径；不要写本机绝对路径。 ## 核心原则 @@ -24,4 +28,4 @@ description: 复杂前端页面增强专家。用于修改当前项目中已经 - 是否破坏了原页面结构和样式 - 是否误删了已有权限控制或交互能力 -- 是否应该拆成子组件而不是继续堆主页面 \ No newline at end of file +- 是否应该拆成子组件而不是继续堆主页面 diff --git a/.codex/skills/frontend-crud-coding/SKILL.md b/.codex/skills/frontend-crud-coding/SKILL.md index 97c52c7ba..aab7790b7 100644 --- a/.codex/skills/frontend-crud-coding/SKILL.md +++ b/.codex/skills/frontend-crud-coding/SKILL.md @@ -1,12 +1,20 @@ --- name: frontend-crud-coding -description: 在当前 plus-ui-new 前端项目中按真实 Vue 3 + TypeScript + Element Plus + oxlint/oxfmt 代码风格生成或修改页面、API、types、hooks 接入和样式壳。用于新增或修改标准 CRUD 列表页、树表页、系统管理页、监控页、workflow 页面、demo 页面，补齐与后端接口对应的 src/api、types 和 src/views 代码；触发后应先读取适用 references，再阅读目标模块真实代码和项目内 gen 代码生成模板。 +description: 在 plus-ui 前端项目中按真实 Vue 3 + TypeScript + Element Plus + oxlint/oxfmt 代码风格生成或修改页面、API、types、hooks 接入和样式壳。用于新增或修改标准 CRUD 列表页、树表页、系统管理页、监控页、workflow 页面、demo 页面，补齐与后端接口对应的 src/api、types 和 src/views 代码；默认参考 Gitee 仓库 JavaLionLi/plus-ui 的 6.X-Vue 分支，触发后应先读取适用 references，再阅读目标模块真实代码和项目内 gen 代码生成模板。 --- # 前端编码规范 先对齐当前前端项目里的真实实现，再参考项目内 `gen` 目录下的代码生成模板。不要只套通用 Vue 模板，也不要把 generator 模板原样复制进来而忽略当前项目已经演进出的 hooks、页面壳、类型入口和下载方式。 +## 项目基线 + +- 基线仓库：`https://gitee.com/JavaLionLi/plus-ui` +- 默认分支：`6.X-Vue` +- 远端引用必须同时标记仓库、分支和文件路径，例如 `https://gitee.com/JavaLionLi/plus-ui/blob/6.X-Vue/gen/index.vue.ftl` 或 `branch=6.X-Vue, path=gen/index.vue.ftl`。 +- 不要在 skill、reference 或 agent 文档中写本机绝对路径；本地文件读取以运行时工作目录为准。 +- 如果用户指定其他分支，先按用户分支读取同一仓库的对应文件，并在结果中说明使用的分支。 + ## 执行流程 1. 判断任务类型：新增标准 CRUD、树表、已有页面增强、复杂业务页、只补 API/types。 diff --git a/.codex/skills/frontend-crud-coding/agents/openai.yaml b/.codex/skills/frontend-crud-coding/agents/openai.yaml index 0999fc74f..ead660269 100644 --- a/.codex/skills/frontend-crud-coding/agents/openai.yaml +++ b/.codex/skills/frontend-crud-coding/agents/openai.yaml @@ -1,7 +1,7 @@ interface: display_name: "前端编码" - short_description: "按 plus-ui-new 真实代码和 gen 模板编写前端 CRUD" - default_prompt: "使用 $frontend-crud-coding 先读取适用 reference，再按当前 plus-ui-new 真实页面、hooks、API/types 约定和项目内 gen 模板实现前端修改。" + short_description: "按 plus-ui 6.X-Vue 真实代码和 gen 模板编写前端 CRUD" + default_prompt: "使用 $frontend-crud-coding 先读取适用 reference，再按 plus-ui Gitee 仓库 6.X-Vue 分支的真实页面、hooks、API/types 约定和项目内 gen 模板实现前端修改。" policy: allow_implicit_invocation: true diff --git a/.codex/skills/frontend-crud-coding/references/examples.md b/.codex/skills/frontend-crud-coding/references/examples.md index fe7ab4cd3..c4cd40b15 100644 --- a/.codex/skills/frontend-crud-coding/references/examples.md +++ b/.codex/skills/frontend-crud-coding/references/examples.md @@ -7,7 +7,7 @@ ```text 使用 $frontend-crud-coding 为 system/client 补一套前端 CRUD 页面。 后端接口已经有 /system/client/list、/system/client/{id}、POST /system/client、PUT /system/client、DELETE /system/client/{ids}。 -请参考项目内 gen 模板、src/views/demo/demo/index.vue 和现有 system/client 风格实现。 +请参考 plus-ui Gitee 仓库 6.X-Vue 分支的项目内 gen 模板、src/views/demo/demo/index.vue 和现有 system/client 风格实现。 ``` ### 期望执行方式 @@ -107,7 +107,7 @@ 2. 新增状态筛选和导出 3. API 路径沿用后端接口 4. 参考 system/config 的工具栏与导出交互 -5. 参考 gen 模板补齐缺失 types +5. 参考 plus-ui Gitee 仓库 6.X-Vue 分支的 gen 模板补齐缺失 types ``` ## 不推荐的任务描述 diff --git a/.codex/skills/frontend-crud-coding/references/frontend.md b/.codex/skills/frontend-crud-coding/references/frontend.md index a934b3223..1fae93bb1 100644 --- a/.codex/skills/frontend-crud-coding/references/frontend.md +++ b/.codex/skills/frontend-crud-coding/references/frontend.md @@ -2,6 +2,7 @@ ## 优先参考的代码来源 +- 默认远端基线：`https://gitee.com/JavaLionLi/plus-ui`，分支 `6.X-Vue`。引用远端文件时必须同时写明 `branch=6.X-Vue` 和仓库内路径。 - 当前目标目录下最近似页面、API、types。 - 标准单表：`src/views/demo/demo/index.vue`、`src/api/demo/demo/index.ts`、`src/api/demo/demo/types.ts`。 - 树表：`src/views/demo/tree/index.vue`、`src/views/workflow/category/index.vue`。 @@ -22,6 +23,7 @@ - `.editorconfig` 要求 UTF-8、LF、2 空格缩进。 - 当前仓库没有 `.prettierrc`；格式化使用 `pnpm run fmt`，lint 使用 `pnpm lint`。 - 不要在一个页面里混入与仓库不一致的格式和写法。 +- 不要把本机绝对路径写进 skill 输出或参考文档；跨环境参考统一使用 Gitee 仓库 URL、分支和仓库内相对路径。 ## API 文件规则 @@ -127,7 +129,8 @@ ## 与 gen 模板的关系 -- `gen` 是当前前端项目内的生成模板，优先于外部后端工程拷贝的模板。 +- `gen` 是 plus-ui 前端项目内的生成模板；默认远端位置是 `https://gitee.com/JavaLionLi/plus-ui/tree/6.X-Vue/gen`，分支必须标记为 `6.X-Vue`。 +- 本地仓库存在对应文件时优先读本地 `gen`，但不要把本地绝对路径写入 skill 或交付内容。 - 新增标准单表页面时读取 `gen/index.vue.ftl`、`gen/api.ts.ftl`、`gen/types.ts.ftl`。 - 新增树表页面时读取 `gen/index-tree.vue.ftl`、`gen/api.ts.ftl`、`gen/types.ts.ftl`。 - `gen` 模板是标准骨架，不是最终答案；落地时仍要对照目标模块真实页面和公共 hooks。