@zat-design/sisyphus-scene 4.5.7 → 4.5.8-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +39 -28
  2. package/mcp/sisyphus-react.json +1 -1
  3. package/package.json +1 -1
  4. package/skills/sisyphus-scene/SKILL.md +32 -8
  5. package/skills/sisyphus-scene/assets/ai-contract.json +1 -1
  6. package/skills/sisyphus-scene/evals/fixtures/valid-decisions.json +4 -4
  7. package/skills/sisyphus-scene/references/approved-examples.yaml +1 -1
package/README.md CHANGED
@@ -1,37 +1,48 @@
1
1
  # Sisyphus Scene
2
2
 
3
- ## 解决什么问题
3
+ ## 用途
4
4
 
5
- 从截图或需求识别保险业务场景，查询真实 Sisyphus API/demo，生成可验证的 React/TypeScript 页面骨架。
5
+ `@zat-design/sisyphus-scene` 从截图或需求识别保险业务场景，强制查询真实 Sisyphus API/demo，生成可验证的 React/TypeScript 页面骨架。
6
6
 
7
- ## 前置版本
7
+ ## 安装
8
8
 
9
- - Node.js 18+
10
- - Sisyphus 组件库、MCP 和 Scene：`4.5.7`
11
- - Ant Design `>=6 <7`
9
+ 需要 Node.js 18+、Sisyphus 4.x 和 Ant Design `>=6 <7`。默认安装 npm `latest` 稳定版：
12
10
 
13
- ## 三步安装
14
-
15
- 1. `npx -y @zat-design/sisyphus-scene@4.5.7 install --check`
16
- 2. `npx -y @zat-design/sisyphus-scene@4.5.7 install`
17
- 3. 重启 AI 工具并调用 `sisyphus-get-meta-status`
11
+ ```bash
12
+ npx -y @zat-design/sisyphus-scene install --check
13
+ npx -y @zat-design/sisyphus-scene install
14
+ ```
18
15
 
19
16
  常用参数：`--global`、`--platform claude,cursor,codex`、`--skip-mcp`、`--skill sisyphus-scene-legacy`。
20
17
 
21
- ## 推荐调用顺序
22
-
23
- 1. `sisyphus-get-meta-status`
24
- 2. `sisyphus-list-components`
25
- 3. `sisyphus-get-component-api`
26
- 4. 按需 `sisyphus-get-type`
27
- 5. `sisyphus-list-examples`
28
- 6. `sisyphus-get-example`
29
-
30
- 开发校验使用 `npm test && npm run validate && npm run mcp:check && npm run pack:check`。发布必须从仓库根目录使用 `yarn release:beta` 或 `yarn release`。
31
-
32
- ## 常见错误
33
-
34
- - MCP 冲突：安装器不覆盖现有异构配置。
35
- - 版本不同：三包必须使用完全相同 SemVer。
36
- - Cursor 找不到 Skill：检查 `.cursor/skills/sisyphus-scene`。
37
- - 发布中断：回到仓库根目录重跑同一命令，已发布的同版本包会被跳过。
18
+ 安装器会将 MCP 锁定到 Scene 自身精确版本。锁版或 beta 项目使用 `@<完整版本>`，并保持组件库、MCP 和 Scene 三包完全同版。
19
+
20
+ ## 场景与 MCP 工具
21
+
22
+ | 场景 | Agent 处理 |
23
+ | --------------- | ---------------------------------------- |
24
+ | 截图还原 | 识别布局/字段/交互，用 MCP 校准组件 |
25
+ | 需求生成 | 建立 SceneSpec，匹配注册场景 |
26
+ | 已有页扩展 | 读相邻代码、做 GitNexus impact、只补需求 |
27
+ | 参考其他项目 | 复用业务结构，重新查询当前 MCP |
28
+ | 无模板场景 | 从组件/demo 组合临时场景 |
29
+ | legacy v3/antd4 | 切换 `sisyphus-scene-legacy` |
30
+
31
+ | MCP 工具 | Scene Agent 中的用途 |
32
+ | ---------------------------- | ----------------------------- |
33
+ | `sisyphus-get-meta-status` | 验证版本、schema 和元数据 |
34
+ | `sisyphus-search` | 将业务语言映射到候选组件/能力 |
35
+ | `sisyphus-list-components` | 确认候选组件存在 |
36
+ | `sisyphus-get-component-api` | 获取候选组件的真实 API |
37
+ | `sisyphus-get-type` | 核对公开 TypeScript 类型 |
38
+ | `sisyphus-list-examples` | 按组件和场景词筛选 demo ID |
39
+ | `sisyphus-get-example` | 获取选中的单个 demo 源码 |
40
+ | `sisyphus-get-examples` | 仅供旧工作流兼容 |
41
+
42
+ ## 开发校验
43
+
44
+ ```bash
45
+ npm test && npm run validate && npm run mcp:check && npm run pack:check
46
+ ```
47
+
48
+ 发布必须从仓库根目录执行 `yarn release:beta` 或 `yarn release`。
package/mcp/sisyphus-react.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "command": "npx",
5
5
  "args": [
6
6
  "-y",
7
- "@zat-design/sisyphus-react-mcp@4.5.7"
7
+ "@zat-design/sisyphus-react-mcp@4.5.8-beta.3"
8
8
  ]
9
9
  }
10
10
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zat-design/sisyphus-scene",
3
- "version": "4.5.7",
3
+ "version": "4.5.8-beta.3",
4
4
  "description": "Sisyphus 业务场景 Agent 技能，跨 Claude Code、Codex、Cursor 分发 Sisyphus 4 + Ant Design 6 场景与 MCP 配置",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/skills/sisyphus-scene/SKILL.md CHANGED
@@ -17,6 +17,17 @@ description: 基于与 Scene Agent 完全同版的 @zat-design/sisyphus-react 4.
17
17
  - 不自动升级依赖、不修改全局布局、不创建新的基础组件库、不把临时场景自动写回本技能。
18
18
  - 不声称“100% 合规”；只汇报实际证据和验证结果。
19
19
 
20
+ ## 工作流总览
21
+
22
+ | 阶段 | 核心动作 | 停止条件 |
23
+ | ---------- | ------------------------------------- | ------------------------------------- |
24
+ | 项目探测 | 读平台规则、依赖和相邻实现 | 规则冲突且无法确定优先级 |
25
+ | 版本门禁 | 校验本地依赖、MCP 元数据和 Scene 契约 | 版本、schema、哈希或 MCP 连接不可验证 |
26
+ | 场景建模 | 从截图/需求建立 `SceneSpec` | 缺少会改变页面结构的关键决策 |
27
+ | MCP 取证 | 查组件、API、类型和单个 demo | 任一必需能力为 `unverified` |
28
+ | 缺口决策 | 为每项需求生成 `ComponentDecision` | 组件体系无法覆盖必需能力 |
29
+ | 生成与验收 | 生成最小文件集并运行项目检查 | 存在未处理的校验或影响风险 |
30
+
20
31
  ## 执行工作流
21
32
 
22
33
  ### 1. 识别平台并探测项目
@@ -52,6 +63,15 @@ node scripts/resolve-versions.mjs --root <项目根目录>
52
63
 
53
64
  提取页面类型、字段、表格列、Tab、弹窗/抽屉、详情分区、步骤锚点、模式、操作、导航、接口、权限和未决项。
54
65
 
66
+ | 用户场景 | 本技能的处理 | 预期产物 |
67
+ | --------------- | ------------------------------------- | ---------------------------- |
68
+ | 截图还原 | 识别结构和状态，再用 MCP 校准组件 | 可运行骨架和视觉差异说明 |
69
+ | 需求生成 | 建立 SceneSpec 并匹配注册场景 | 最小 React/TypeScript 文件集 |
70
+ | 已有页扩展 | 读相邻实现、做 impact、只补需求 | 手术式修改和回归结果 |
71
+ | 参考其他项目 | 复用业务结构，重查当前 MCP 和目标规则 | 不携带旧 API 的目标实现 |
72
+ | 无模板组合 | 从组件/demo 组合临时场景 | 本次任务的可验证结构 |
73
+ | legacy v3/antd4 | 切换 `sisyphus-scene-legacy` | legacy 技术栈页面骨架 |
74
+
55
75
  读取：
56
76
 
57
77
  - `references/scene-model.md`：场景识别与能力组合
@@ -62,14 +82,18 @@ node scripts/resolve-versions.mjs --root <项目根目录>
62
82
 
63
83
  ### 4. 强制查询 Sisyphus MCP
64
84
 
65
- 对本次候选组件依次执行：
66
-
67
- 1. `sisyphus-get-meta-status`
68
- 2. `sisyphus-list-components`
69
- 3. `sisyphus-get-component-api(<组件名>)`
70
- 4. 需要类型声明时调用 `sisyphus-get-type(<类型名>)`
71
- 5. `sisyphus-list-examples(<组件名>, <场景关键词>)`
72
- 6. `sisyphus-get-example(<示例 ID>)`
85
+ 对本次候选组件按表格取证：
86
+
87
+ | MCP 工具 | Scene Agent 中的用途 |
88
+ | ---------------------------- | ----------------------------- |
89
+ | `sisyphus-get-meta-status` | 验证版本、schema 和元数据 |
90
+ | `sisyphus-search` | 将业务语言映射到候选组件/能力 |
91
+ | `sisyphus-list-components` | 确认候选组件存在 |
92
+ | `sisyphus-get-component-api` | 为候选组件取得真实 API |
93
+ | `sisyphus-get-type` | 核对公开 TypeScript 类型 |
94
+ | `sisyphus-list-examples` | 按组件和场景词筛选 demo ID |
95
+ | `sisyphus-get-example` | 获取选中的单个 demo 源码 |
96
+ | `sisyphus-get-examples` | 仅供旧工作流兼容 |
73
97
 
74
98
  记录结构化 API/demo 证据，包含工具名、目标、完整版本、schema v2 和 demo ID。禁止为找一个用法一次拉取全部 demo 源码。
75
99
 
package/skills/sisyphus-scene/assets/ai-contract.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "4.5.7",
2
+ "version": "4.5.8-beta.3",
3
3
  "schemaVersion": 2,
4
4
  "tools": [
5
5
  "sisyphus-get-meta-status",
package/skills/sisyphus-scene/evals/fixtures/valid-decisions.json CHANGED
@@ -8,13 +8,13 @@
8
8
  "apiEvidence": {
9
9
  "tool": "sisyphus-get-component-api",
10
10
  "target": "ProForm",
11
- "libraryVersion": "4.5.7",
11
+ "libraryVersion": "4.5.8-beta.3",
12
12
  "schemaVersion": 2
13
13
  },
14
14
  "demoEvidence": {
15
15
  "tool": "sisyphus-get-example",
16
16
  "target": "ProForm/demos/base.tsx",
17
- "libraryVersion": "4.5.7",
17
+ "libraryVersion": "4.5.8-beta.3",
18
18
  "schemaVersion": 2,
19
19
  "exampleId": "ProForm/demos/base.tsx"
20
20
  }
@@ -28,13 +28,13 @@
28
28
  "apiEvidence": {
29
29
  "tool": "sisyphus-get-component-api",
30
30
  "target": "ProTable",
31
- "libraryVersion": "4.5.7",
31
+ "libraryVersion": "4.5.8-beta.3",
32
32
  "schemaVersion": 2
33
33
  },
34
34
  "demoEvidence": {
35
35
  "tool": "sisyphus-get-example",
36
36
  "target": "ProTable/demos/base.tsx",
37
- "libraryVersion": "4.5.7",
37
+ "libraryVersion": "4.5.8-beta.3",
38
38
  "schemaVersion": 2,
39
39
  "exampleId": "ProTable/demos/base.tsx"
40
40
  }
package/skills/sisyphus-scene/references/approved-examples.yaml CHANGED
@@ -7,7 +7,7 @@ examples: []
7
7
  # status: approved
8
8
  # application: xk-wjs-claim-web
9
9
  # capabilities: [search-form, data-table, table-tabs, drawer-form]
10
- # sisyphus_version: "4.5.7"
10
+ # sisyphus_version: "4.5.8-beta.3"
11
11
  # antd_range: ">=6 <7"
12
12
  # paths:
13
13
  # - src/pages/litigationManagement/index.tsx