@mingfuyun/star-allinone 0.2.0 → 0.3.0

package/skills/README.md

@@ -10,12 +10,14 @@
 
 ```text
 starscope-frontend/
+├── AGENTS.md
 ├── .star-allinone.json
 └── .agents/
     ├── skills/
     │   ├── shared-api-to-service/
     │   ├── shared-api-mock/
     │   ├── shared-design-to-page/
+    │   ├── shared-page-recipe/
     │   ├── shared-verify/
     │   ├── shared-review-and-submit/
     │   ├── shared-publish-test/
@@ -30,11 +32,13 @@ StarLink：
 
 ```text
 starlink-frontend/
+├── AGENTS.md
 └── .agents/
     └── skills/
         ├── shared-api-to-service/
         ├── shared-api-mock/
         ├── shared-design-to-page/
+        ├── shared-page-recipe/
         ├── shared-verify/
         ├── shared-review-and-submit/
         ├── shared-publish-test/
@@ -50,6 +54,8 @@ custom-*   业务定制 skill，由业务项目维护
 
 这样所有 skill 都在业务项目中，Codex 可以直接发现；同时通过名称可以清楚区分来源。
 
+Cursor / Codex 的常驻说明只放仓库根 `AGENTS.md`（模板见 `examples/AGENTS.md`）。项目差异放 `.agents/project/`。不要新增 `.cursor/rules`。
+
 ## npm 包的职责
 
 `@mingfuyun/star-allinone` 包中保存公共 skill 源文件。每个 skill 包含可执行规则，细节放在同目录 `references/`：
@@ -65,6 +71,7 @@ custom-*   业务定制 skill，由业务项目维护
         │       └── api-artifact-generation.md
         ├── api-mock/
         ├── design-to-page/          # page-conventions.md + overlays.md
+        ├── page-recipe/             # 标准列表页；CLI `gen page`
         ├── project-conventions/     # architecture / review-checklist / quality-checklist
         ├── verify/
         ├── review-and-submit/
@@ -173,7 +180,7 @@ git commit -m "feat(skill): 增加设备管理 skill"
 
 不需要修改 `star-allinone`，也不需要重新发布 npm。
 
-审查、提交、测试环境发布、Mock 和 Service 生成都走公共 skill。只有流水线 ID 放在业务项目的 `.star-allinone.json`。`custom-*` 只用于真正的业务特例，例如设备管理或节点管理。
+审查、提交、测试环境发布、单接口 Mock/Service、标准列表都走公共入口 skill。`custom-*` 只用于真正的业务特例。单接口生成禁止再做 custom；只有整份契约全量重建才允许留在 custom，并必须在 description 里写明「只用于全量」。度量类 custom 不得生成代码。
 
 ## 公共部分和业务定制组合
 
@@ -214,6 +221,7 @@ description: Generate StarScope device service code.
 
 ```text
 starscope-frontend/
+├── AGENTS.md
 ├── .star-allinone.json
 └── .agents/
     ├── skills/
@@ -247,6 +255,24 @@ StarLink 使用：
 
 可选字段 `sharedSkills` 用于只同步部分公共 skill；省略时同步 `skills/shared` 下的全部公共 skill。
 
+## 用户入口 vs 内部 skill
+
+对话里只点这些入口：
+
+| 入口 | 用途 |
+| --- | --- |
+| `shared-api-to-service` | 单个 `METHOD /path/` → 类型、`MFRequest`、默认 mock |
+| `shared-page-recipe` | 标准列表页（表格 + 抽屉 + 确认） |
+| `shared-design-to-page` | 非标准设计稿 |
+| `shared-review-and-submit` | 审查并提交（内部会读 impact / verify / commit） |
+| `shared-publish-test` | 测发 |
+
+下面这些会随包同步，但 **不要作为用户入口调用**（`disable-model-invocation`）。入口 skill 会去读对应 `SKILL.md`：
+
+`shared-api-mock`、`shared-project-conventions`、`shared-verify`、`shared-impact-analysis`、`shared-ai-review`、`shared-commit-current-changes`、`shared-i-have-adhd`
+
+`custom-*` 禁止再实现一遍上述入口。单接口生成走公共 CLI；只有「整份契约全量重建」才允许留在 custom（例如 StarLink `custom-swagger-to-markdown`）。度量类 custom 不得生成代码。
+
 ## 公共规则写在哪里
 
 | Skill | 规则位置 | 覆盖内容 |
@@ -254,6 +280,7 @@ StarLink 使用：
 | `shared-api-to-service` | SKILL + `references/service-conventions.md`、`api-artifact-generation.md` | 指定 operation、`MFRequest` 映射、namespace 类型、snake_case、schema 闭包、禁止改 transport |
 | `shared-api-mock` | SKILL + `references/mock-conventions.md` | 对话 JSON 默认、完整响应信封、分页/空列表/错误场景、禁止 handler 和随机数 |
 | `shared-design-to-page` | SKILL + `references/page-conventions.md`、`overlays.md` | 页面分层、`MFProTable`、`ProForm`、权限、异步、`HocModal` 弹层合同 |
+| `shared-page-recipe` | SKILL + `references/list-page-template.md` | 标准列表页文件树；先跑 `star-allinone gen page` |
 | `shared-project-conventions` | SKILL + `references/architecture.md`、`review-checklist.md`、`quality-checklist.md` | 架构边界、质量禁令、审查清单；其他 skill 会引用这些文件 |
 | `shared-verify` | SKILL | 成套产物检查、await/loading/弹层、验证命令和报告格式 |
 | `shared-impact-analysis` | SKILL | 只读影响分类和回归路径 |
@@ -290,9 +317,10 @@ star-allinone 修改
 最终结构和责任边界：
 
 ```text
+AGENTS.md           ← 常驻约定，不要加 .cursor/rules
 .agents/skills/
-├── shared-*    ← npm 包同步，不能在业务项目直接维护
-└── custom-*    ← 业务项目自己维护
+├── shared-*        ← npm 包同步，不能在业务项目直接维护
+└── custom-*        ← 业务项目自己维护
 ```
 
 这比全局安装更适合团队协作，也比把公共 skill 藏在 `node_modules` 中更可靠，因为公共 skill 最终会进入业务项目仓库，团队成员拉取代码后即可直接使用。

package/skills/shared/ai-review/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Review frontend changes for correctness, API and permission contracts, React lifecycle, performance, maintainability, security, accessibility, and test gaps. Use for a standalone review without commit. Do not modify files.
+description: Internal. Do not invoke. Standalone review checklist used by shared-review-and-submit. Do not modify files.
+disable-model-invocation: true
 ---
 
 # AI Code Review
 
+Not a user-facing entry. Do not invoke this skill. `shared-review-and-submit` covers review. Do not treat this as a generate or submit entry.
+
 This skill is fully shared. Review the current diff plus relevant callers and types. Before reviewing, read:
 
 1. `.agents/skills/shared-project-conventions/references/review-checklist.md`

package/skills/shared/api-mock/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Generate deterministic API mock responses matching the active frontend project's OpenAPI contract and service types. Use when the user asks for JSON fixtures, proxy-ready mock data, empty or error scenarios, or mock files for a specified endpoint.
+description: Internal. Do not invoke. Called by shared-api-to-service when extra mock scenarios are needed. Not a user-facing generate-service entry.
+disable-model-invocation: true
 ---
 
 # API Mock
 
+Not a user-facing entry. Do not invoke this skill. `shared-api-to-service` reads this file when extra mock scenarios are needed. Generating types or `MFRequest` methods is not this skill's job.
+
 This skill is fully shared. Read [references/mock-conventions.md](references/mock-conventions.md), `.star-allinone.json`, the related service types, and the OpenAPI file from `openapi` in `.star-allinone.json` (or the document provided in this conversation).
 
 If the service contract is missing, first follow `.agents/skills/shared-api-to-service/SKILL.md`.

package/skills/shared/api-to-service/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: {{sharedSkillName}}
-description: Generate frontend TypeScript API types, MFRequest service methods, aggregate exports, and contract-aligned mock artifacts for an explicitly selected API operation. Use when the user names an endpoint or operationId and asks to generate or update service, types, or mock data.
+description: User-facing. Generate or update one OpenAPI/Swagger operation as TypeScript types, an MFRequest method, and optional mock JSON. Use for a named METHOD /path or operationId. Do not use for full-spec domain regen.
 ---
 
 # API to Service
 
+User-facing entry for **one** `METHOD /path/` or `operationId`. Do not regenerate an entire Swagger domain here. StarLink full-spec rebuilds stay on `custom-swagger-to-markdown`.
+
 This skill is fully shared. Generate only the requested `METHOD /path/` or `operationId`. Do not guess undocumented fields or change unrelated endpoints.
 
 Read before editing:
@@ -25,12 +27,18 @@ OpenAPI lookup order:
 ## Workflow
 
 1. Resolve one exact operation. If a path has multiple methods and intent is unclear, ask for the method. Never infer a destructive method.
-2. Recursively resolve parameters, request body, responses, and local `$ref`s. Neighboring methods that share a path are out of scope.
-3. Build the target matrix in `api-artifact-generation.md`. Compare existing types, methods, exports, and mocks. Classify create / update / reuse / conflict.
-4. Report contract conflicts before overwriting deployed behavior.
-5. Update `src/services/<Domain>/typings.d.ts`, the thin `MFRequest` method, and `src/services/index.ts` when the domain export is missing.
-6. Produce the default successful JSON mock. Add empty or error variants only when requested.
-7. Verify formatting, TypeScript, JSON parsing, exact method/path, and a focused diff.
+2. From the business project root, generate the artifacts with the CLI. Do not hand-write types or `MFRequest` methods when the spec exists:
+
+```bash
+pnpm exec star-allinone gen service --operation "GET /api/v1/devices/"
+```
+
+Use `--spec <file>` when `.star-allinone.json` has no `openapi`. Use `--domain <Name>` when the folder cannot be inferred. Use `--mock-file` only when the user asked for a mock file; otherwise keep the default conversation JSON.
+
+3. If the CLI reports reuse, keep the existing method. If it reports a conflict, stop and show the diff; do not overwrite.
+4. Review the generated types against the spec: snake_case, optionality, `| null`, unwrapped `data`, and exact method/path.
+5. Produce extra empty or error mocks only when requested, using `.agents/skills/shared-api-mock/SKILL.md`.
+6. Verify formatting, TypeScript, JSON parsing, exact method/path, and a focused diff.
 
 ## Hard rules
 
@@ -45,7 +53,7 @@ OpenAPI lookup order:
 
 ```bash
 pnpm exec prettier --check <changed-service-and-json-files>
-pnpm exec tsc --noEmit
+pnpm typecheck
 ```
 
 Parse changed JSON files. Search generated names, operationId, and exact API paths for omissions and collisions. Run `pnpm lint` for broad service changes. Cite the OpenAPI path, method, operationId, and schema names in the handoff.

package/skills/shared/commit-current-changes/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Review the active frontend project's changes and prepare a confirmation-gated Conventional Commit and optional push. Use when the user asks to review current changes, submit code, or commit and push. Never commit before explicit confirmation.
+description: Internal. Do not invoke. Step 3 of shared-review-and-submit. Confirmation-gated commit only after that entry skill has run.
+disable-model-invocation: true
 ---
 
 # Commit Current Changes
 
+Not a user-facing entry. Do not invoke this skill when the user says 提交 or 审查. Use `shared-review-and-submit`, which calls this file as step 3.
+
 This skill is fully shared. Review user-authorized working-tree changes, report findings and a commit proposal, and mutate Git only after explicit confirmation.
 
 ## Write-operation gate

package/skills/shared/design-to-page/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: {{sharedSkillName}}
-description: Implement frontend pages from designs using the active project's React, Umi, Ant Design Pro, service, permission, routing, and component conventions. Use when translating Figma, screenshots, wireframes, or UI specs into page code.
+description: User-facing. Implement a non-standard page from Figma, screenshots, or UI specs. For a standard table + drawer + confirm list, use shared-page-recipe instead.
 ---
 
 # Design to Page
 
+User-facing entry for **non-standard** pages. If the request is a standard table + drawer + confirm list, stop and follow `shared-page-recipe` instead.
+
 Translate a design into repository-native code. Reuse existing architecture; do not invent a parallel stack.
 
 Before implementation, read:
@@ -18,6 +20,8 @@ If `.agents/project/conventions.md` exists, use it only for extra paths.
 
 Inspect the nearest existing page of the same type before proposing files.
 
+If the request is a standard management list (table + query + drawer form + confirm), use `.agents/skills/shared-page-recipe/SKILL.md` and `pnpm exec star-allinone gen page` instead of guessing the file tree.
+
 ## Workflow
 
 1. List visible states: default, loading, empty, error, disabled, overflow, permission, and narrow-screen.

package/skills/shared/i-have-adhd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: {{sharedSkillName}}
-description: 'Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress tangents, give specific time estimates, make wins visible. Invoke with /i-have-adhd; stays on until "stop adhd mode".'
+description: Internal output style. Do not invoke as a task. Other shared skills apply this file to user-facing replies. Turn on with /i-have-adhd; off with stop adhd mode.
 disable-model-invocation: true
 license: MIT
 metadata:

package/skills/shared/impact-analysis/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Analyze frontend Git changes and trace affected routes, pages, services, permissions, shared components, mocks, and regression checks. Read-only. Use for PR or pre-submit impact analysis.
+description: Internal. Do not invoke. Step 1 of shared-review-and-submit. Read-only impact tracing.
+disable-model-invocation: true
 ---
 
 # Impact Analysis
 
+Not a user-facing entry. Do not invoke this skill. `shared-review-and-submit` runs this as step 1.
+
 This skill does not modify files.
 
 ## Workflow

package/skills/shared/page-recipe/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: {{sharedSkillName}}
+description: User-facing. Scaffold a standard management list (route, MFProTable, drawer form, confirm modal, permissions, services). Use for CRUD list pages. Do not use for dashboards or one-off layouts.
+---
+
+# List Page Recipe
+
+User-facing entry for a **standard** management list. Dashboards, iframes, and one-off layouts use `shared-design-to-page`.
+
+Scaffold a standard management list. Do not use this for dashboards, iframes, or one-off visualizations. Those stay on `shared-design-to-page`.
+
+Read before editing:
+
+1. `.star-allinone.json`
+2. `.agents/skills/shared-design-to-page/references/page-conventions.md`
+3. `.agents/skills/shared-design-to-page/references/overlays.md`
+4. [references/list-page-template.md](references/list-page-template.md)
+5. `.agents/project/conventions.md` if it exists
+
+## Required inputs
+
+Collect any missing item before generating:
+
+- Feature folder (`src/pages/<Feature>`)
+- Route path and menu title
+- List operation (`METHOD /path/` or `operationId`)
+- Optional create / update / delete operations
+- Optional permission codes for create / edit / delete
+
+## Workflow
+
+1. Run the CLI from the business project root. Prefer this over hand-writing the skeleton:
+
+```bash
+pnpm exec star-allinone gen page \
+  --feature <Feature> \
+  --route /path \
+  --title <中文标题> \
+  --list-operation "GET /api/v1/resource/" \
+  --create-operation "POST /api/v1/resource/" \
+  --update-operation "PATCH /api/v1/resource/{id}/" \
+  --delete-operation "DELETE /api/v1/resource/{id}/"
+```
+
+Add `--permission-create`, `--permission-edit`, `--permission-delete` when codes are known.
+
+2. If only services are missing, run `pnpm exec star-allinone gen service --operation "METHOD /path/"` first. Follow `.agents/skills/shared-api-to-service/SKILL.md`.
+3. Fill generated placeholders: columns, form fields, rowKey, permission constants, and pagination adapter (`results/count` vs `list/total`) using the nearest page of the same type.
+4. If `src/components/Page/Container/config.tsx` exists, register the new page as a tab after generating the standalone files. Do not invent a second page shell.
+5. Run focused verification.
+
+## Hard rules
+
+- `MFProTable` for the list. `ProForm` inside `CustomDrawer`. Confirmations use `BaseModal` + `HocModal`.
+- Pages consume `import Service from '@/services'` only.
+- Keep columns and toolbar builders in `const.tsx`.
+- Every `await` uses `try-catch`; restore loading in `finally`.
+- Do not use `Modal.confirm` or feature-level Ant Design `Modal` / `Drawer` shells.
+- Do not overwrite existing page files. Tell the user the CLI refused, then edit in place.
+
+## Verification
+
+```bash
+pnpm exec prettier --check <changed-files>
+pnpm typecheck
+```
+
+Run `pnpm lint` when routes or shared components change.
+
+## User-facing output
+
+Read and apply `.agents/skills/shared-i-have-adhd/SKILL.md` to every response this skill sends to the user.

package/skills/shared/page-recipe/references/list-page-template.md

@@ -0,0 +1,44 @@
+# List page template
+
+The CLI writes this tree. Edit the generated files; do not recreate a parallel structure.
+
+```text
+config/route.ts
+src/pages/<Feature>/
+├── index.tsx
+├── index.less
+├── const.tsx
+└── components/
+    ├── <Feature>Drawer.tsx
+    └── <Feature>ConfirmModal.tsx
+```
+
+## index.tsx
+
+- Wrap with `PageContainer` when `src/components/PageContainer` exists.
+- `fetchData` is a `useCallback` that calls `Service.<listFn>`, maps pagination, and returns `{ code, data: { list, total } }`.
+- Open the drawer with `drawerRef.current?.show({ record })`.
+- Destructive actions go through the confirm modal ref, then `tableRef.current?.reload()`.
+
+## const.tsx
+
+- Export `columns`, `getActionColumn`, `getToolBarRender`.
+- Put permission strings on actions and toolbar items when the project uses them.
+- Render empty cells as `'-'`.
+
+## Drawer
+
+- `CustomDrawer` + `HocModal`.
+- `ProForm` with `submitter={false}` and `layout="horizontal"`.
+- `validateFields()` in `try`. Create vs update from `record`.
+- Reset fields when `visible` becomes true.
+
+## Confirm modal
+
+- `BaseModal` + `HocModal`.
+- `confirmLoading` tied to the async `onConfirm`.
+- Do not use `Modal.confirm`.
+
+## StarScope tabs
+
+If the project uses `src/components/Page/Container/config.tsx`, the generated `src/pages/<Feature>/index.tsx` is still the source of truth. Add a tab entry that renders the feature component. Do not duplicate fetch logic inside Container.

package/skills/shared/project-conventions/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Apply the active frontend project's architecture, API, business, permission, performance, testing, and naming conventions to generated or reviewed code.
+description: Internal. Do not invoke. Referenced by other shared skills for architecture and hard rules. Not a user-facing task.
+disable-model-invocation: true
 ---
 
 # Project Conventions
 
+Not a user-facing entry. Do not invoke this skill. Other shared skills read this file for architecture and hard rules.
+
 Use this skill for every non-trivial change. Preserve existing patterns and make the smallest scoped change.
 
 Read in this order:

package/skills/shared/project-conventions/references/architecture.md

@@ -4,6 +4,7 @@ Apply these rules to every non-trivial frontend change. Shared review, commit, m
 
 ## Architecture
 
+- Always-on agent instructions live in the repo-root `AGENTS.md`. Do not add `.cursor/rules`.
 - Use React function components and TypeScript.
 - Put transport code in `src/services`. Pages must not call axios or the request helper directly.
 - Keep API DTOs in the domain `typings.d.ts`. Use named types and adapters instead of `any`.
@@ -38,6 +39,8 @@ pnpm exec prettier --check <changed-files>
 pnpm exec tsc --noEmit
 ```
 
+Prefer `pnpm typecheck` when that script exists.
+
 Run `pnpm lint` for broad or shared changes. Run `pnpm run build` when routes, entry behavior, shared runtime, or multiple page modules change. If `.star-allinone.json` documents a TypeScript `baseUrl` or build script, use that command.
 
 Distinguish failures introduced by the current change from pre-existing or environment failures.

package/skills/shared/publish-test/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: {{sharedSkillName}}
-description: Publish the current frontend Git branch to the project's Yunxiao test pipeline only after explicit confirmation such as 确认推送流水线 or 发布测试环境. Never run the pipeline automatically after git push.
+description: User-facing. Publish the current Git branch to the Yunxiao test pipeline after explicit confirmation such as 确认推送流水线. Never run automatically after git push.
 ---
 
 # Publish Test Environment
 
+User-facing entry for test-environment publish only.
+
 This skill is fully shared. The only project-specific value is `publishPipelineId` in `.star-allinone.json`.
 
 Do not run the pipeline script after a git push. Git push, `确认提交并推送`, and `确认` are not pipeline authorization.

package/skills/shared/review-and-submit/SKILL.md

@@ -1,10 +1,12 @@
 ---
 name: {{sharedSkillName}}
-description: Run the frontend pre-submit workflow: impact analysis, verification, then confirmation-gated commit review. Use when the user asks for the full submit flow or says 使用完整流程提交代码. Never stage, commit, or push before explicit confirmation.
+description: User-facing. Pre-submit workflow: impact analysis, verify, then confirmation-gated commit. Use when the user wants to review, submit, or commit. Do not invoke impact/verify/commit skills separately.
 ---
 
 # Review and Submit
 
+User-facing entry for review, submit, and commit. Do not tell the user to invoke `shared-impact-analysis`, `shared-verify`, `shared-ai-review`, or `shared-commit-current-changes` separately. Read those files in order.
+
 This is the unified pre-submit entry and is fully shared. Do not mutate Git until the user confirms the exact reviewed scope.
 
 If `.agents/project/review-rules.md` exists, apply extra domain checks only; do not weaken shared hard rules.

package/skills/shared/verify/SKILL.md

@@ -1,10 +1,13 @@
 ---
 name: {{sharedSkillName}}
-description: Verify generated or manually changed frontend code against shared conventions, API contracts, permissions, async behavior, and validation commands. Use after API, mock, page, or refactor work. Do not generate business code.
+description: Internal. Do not invoke. Step 2 of shared-review-and-submit. Not a user-facing generate or review entry.
+disable-model-invocation: true
 ---
 
 # Frontend Verification
 
+Not a user-facing entry. Do not invoke this skill. `shared-review-and-submit` runs this as step 2.
+
 This skill is fully shared. Read the current diff, related callers, and:
 
 1. `.agents/skills/shared-project-conventions/references/review-checklist.md`
@@ -28,7 +31,7 @@ Choose by risk. Do not auto-fix to make a command pass.
 git diff --check
 pnpm exec prettier --check <changed-files>
 pnpm exec eslint <changed-files>
-pnpm exec tsc --noEmit
+pnpm typecheck
 pnpm lint
 ```