soloforge 1.2.7 → 1.2.8
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.
- package/README.md +1 -1
- package/package.json +1 -1
- package/templates/knowledge/acceptance_templates//345/216/237/345/236/213/350/257/264/346/230/216/346/250/241/347/211/210.md +30 -2
- package/templates/knowledge/procedures/{Figma → /346/272/220/347/240/201/345/216/237/345/236/213}/344/272/244/344/273/230/346/265/201/347/250/213.md +5 -5
package/README.md
CHANGED
|
@@ -68,7 +68,7 @@ soloforge init --interactive # 手动补充配置
|
|
|
68
68
|
|--------|---------|------|
|
|
69
69
|
| Claude Code | `.claude/settings.json` | Hooks 配置(PreToolUse/PostToolUse) |
|
|
70
70
|
| | `CLAUDE.md` | 工作流规则文件 |
|
|
71
|
-
| | `.mcp.json` | MCP Server 配置(SoloForge + Playwright
|
|
71
|
+
| | `.mcp.json` | MCP Server 配置(SoloForge + Playwright) |
|
|
72
72
|
| Trae IDE | `.trae/mcp.json` | MCP Server 配置 |
|
|
73
73
|
| | `.trae/rules/project_rules.md` | 项目规则文件 |
|
|
74
74
|
| Codex App | `.codex/config.toml` | MCP Server 配置(TOML 格式) |
|
package/package.json
CHANGED
|
@@ -1,24 +1,52 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: prototype-specification
|
|
3
3
|
type: acceptance_template
|
|
4
|
-
when: "原型, 设计稿, UI规范, 前端实现, 页面交互,
|
|
4
|
+
when: "原型, 设计稿, UI规范, 前端实现, 页面交互, 交互规约, Figma Make导出源码, 原型源码zip, React/Vite原型"
|
|
5
5
|
scope: [frontend]
|
|
6
6
|
products: ["*"]
|
|
7
7
|
---
|
|
8
8
|
|
|
9
9
|
# [页面名称] 原型与交互规约
|
|
10
10
|
|
|
11
|
+
## 0. 源码提取约束
|
|
12
|
+
> **硬性约束:** 原型说明只能从 Figma Make 导出的源码包(如 React/Vite zip)或已解压源码目录中提取。禁止使用 Figma MCP、浏览器运行态、站点截图或纯 Design 文件补充原型信息。若未提供源码包或源码目录,必须停止并要求补充源码输入。
|
|
13
|
+
|
|
14
|
+
### 0.1 输入来源
|
|
15
|
+
- **[Source Code]** 原型源码包路径:[如:/Downloads/xxx.zip;解压后 src/app/pages、routes.tsx、theme.css、imports/*.md]
|
|
16
|
+
- **[Requirement Doc]** PRD/需求说明:[如:docs/xxx.md]
|
|
17
|
+
|
|
18
|
+
### 0.2 必须读取的源码材料
|
|
19
|
+
1. `package.json`、`vite.config.*`、`src/main.*`、`src/app/App.*`:识别原型入口和运行框架。
|
|
20
|
+
2. `src/app/routes.*`:提取路由、页面清单和入口关系。
|
|
21
|
+
3. `src/app/pages/**/*`:提取页面结构、组件层级、文案、表单字段和业务模块。
|
|
22
|
+
4. `src/app/components/**/*`:提取复用组件、弹窗、菜单、表格、卡片和交互控件。
|
|
23
|
+
5. `src/styles/**/*`、`theme.css`、Tailwind 配置:提取颜色、字体、间距、圆角、阴影等设计令牌。
|
|
24
|
+
6. `src/imports/**/*`、`docs/**/*`:提取 Figma Make 导入的业务说明、图片和补充文档。
|
|
25
|
+
|
|
26
|
+
### 0.3 禁止使用的来源
|
|
27
|
+
- 禁止使用 Figma MCP 作为原型信息来源。
|
|
28
|
+
- 禁止使用 Playwright/浏览器访问 Figma Make 或 `.figma.site` 来补充交互。
|
|
29
|
+
- 禁止从截图、肉眼观察或 Design 文件臆测源码中不存在的状态。
|
|
30
|
+
- 源码中无法确认的信息必须标记为 `[Manual Confirm]`。
|
|
31
|
+
|
|
32
|
+
### 0.4 证据标记
|
|
33
|
+
- `[Source Code]` 来自原型源码、路由、组件、hooks、样式或导入文档。
|
|
34
|
+
- `[Source Doc]` 来自源码包内的 imports/docs/README/Markdown 文档。
|
|
35
|
+
- `[Source Asset]` 来自源码包内图片、图标或静态资源。
|
|
36
|
+
- `[Manual Confirm]` 需要人工确认。
|
|
37
|
+
|
|
11
38
|
## 1. 页面元数据
|
|
12
39
|
- **所属模块/端**:[如:家属端小程序 / 机构端 Web / 运营端后台]
|
|
13
40
|
- **关联 PRD 节点**:[如:3.2.1 价值交换流程 - A.2 比较方案]
|
|
14
41
|
- **页面核心目标**:[一句话描述]
|
|
15
42
|
- **页面路由路径**:[如:/institution/compare]
|
|
16
43
|
- **入口来源**:[如:首页推荐卡片点击 / 侧边栏菜单]
|
|
44
|
+
- **提取依据**:[Source Code / Source Doc / Source Asset / Manual Confirm]
|
|
17
45
|
|
|
18
46
|
---
|
|
19
47
|
|
|
20
48
|
## 2. 设计令牌 (Design Tokens)
|
|
21
|
-
> **说明:**
|
|
49
|
+
> **说明:** 只能从 `theme.css`、`globals.css`、Tailwind 配置、组件 className 和内联样式提取。AI 实现时必须引用这些令牌而非硬编码数值。
|
|
22
50
|
|
|
23
51
|
### 2.1 色彩
|
|
24
52
|
| 令牌名 | 色值 | 用途 |
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: source-prototype-to-delivery
|
|
3
3
|
type: pipeline_procedure
|
|
4
|
-
when: "
|
|
4
|
+
when: "用户提供需求文档、原型源码zip、React/Vite原型"
|
|
5
5
|
scope: [backend, frontend]
|
|
6
6
|
products: ["*"]
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# 源码原型需求到交付
|
|
10
10
|
|
|
11
11
|
### 第1步:原型抓取
|
|
12
|
-
|
|
12
|
+
只能从导出的源码包(如 React/Vite zip)或已解压源码目录提取原型信息:路由、页面组件、布局结构、状态变量、事件处理、弹窗/导航/表单交互、样式令牌和导入的业务说明。禁止使用 Figma MCP、浏览器运行态、figma.site 或截图作为补充来源。若未提供源码包或源码目录,停止原型抓取并要求补充源码输入。对每个端或页面独立输出原型说明。
|
|
13
13
|
模板:原型说明模版.md
|
|
14
14
|
产出保存到:.soloforge/output/01-原型说明.md
|
|
15
|
-
工具:
|
|
15
|
+
工具:source
|
|
16
16
|
|
|
17
17
|
### 第2步:架构设计
|
|
18
18
|
根据原型说明和需求文档,设计系统模块划分、数据流向、技术选型与依据、风险点与应对方案。
|