@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.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.
- package/README.md +53 -49
- package/docs/README.md +1 -0
- package/docs/agent-install-guide.md +113 -0
- package/docs/alpha-test-guide.md +2 -0
- package/docs/product-direction.md +6 -4
- package/docs/roadmap.html +25 -11
- package/docs/roadmap.md +33 -8
- package/docs/v0.1-plan.md +11 -4
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,83 +1,87 @@
|
|
|
1
1
|
# StarWork
|
|
2
2
|
|
|
3
|
-
StarWork
|
|
3
|
+
StarWork 是一套面向 AI Agent 的工作台协议和工具集,用来帮助用户把长期工作、跨会话协作、多项目管理和 Agent 工作流组织清楚。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
它包含四个核心部分:
|
|
6
6
|
|
|
7
|
-
- **Core
|
|
8
|
-
- **CLI
|
|
9
|
-
- **Packs
|
|
10
|
-
- **Skills
|
|
7
|
+
- **Core**:定义工作台应该长什么样,包括目录结构、角色边界、状态文件和健康检查规则。
|
|
8
|
+
- **CLI**:提供 `init`、`doctor`、`spawn`、`adapt`、`pack install` 等命令,用来创建、检查和扩展工作台。
|
|
9
|
+
- **Packs**:场景模板包。当前 A 测阶段默认使用通用 Pack。
|
|
10
|
+
- **Skills**:给 Codex 等 Agent 使用的工作流说明,让 Agent 能更可靠地帮用户设计和生成 StarWork 工作台。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
当前版本处于 A 测阶段,适合测试安装流程、基础命令、工作台结构和 Agent skill 使用体验。
|
|
13
13
|
|
|
14
|
-
##
|
|
14
|
+
## 安装 CLI
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
全局安装:
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
19
|
npm install -g @jennie-shawn/starwork
|
|
20
20
|
starwork --help
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
不全局安装,直接运行:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
26
|
npx @jennie-shawn/starwork --help
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
##
|
|
29
|
+
## 安装 Skills
|
|
30
30
|
|
|
31
|
-
StarWork skills
|
|
31
|
+
StarWork skills 通过 GitHub 仓库和 `skills` CLI 分发。
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
给 Codex 安装全部 StarWork skills:
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
36
|
npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
单独安装某个 skill:
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
42
|
npx skills add jennie-shawn/starwork --skill starworkInit -g -a codex -y
|
|
43
43
|
npx skills add jennie-shawn/starwork --skill starworkSpawn -g -a codex -y
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
当前 skills:
|
|
47
47
|
|
|
48
|
-
- `starworkInit
|
|
49
|
-
- `starworkSpawn
|
|
48
|
+
- `starworkInit`:帮助 Agent 判断工作台类型、语言、是否需要事项,并生成友好的 `starwork init` 初始化方案。
|
|
49
|
+
- `starworkSpawn`:帮助 Agent 为已有 Hub 设计 `starwork spawn --blueprint` 工作台定制单。
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
如果你希望让 Agent 帮你完成安装,可以把 [Agent 安装指南](docs/agent-install-guide.md) 里的提示词发给你的 Agent。
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
## 快速开始
|
|
54
|
+
|
|
55
|
+
创建一个长期单项目工作台:
|
|
54
56
|
|
|
55
57
|
```bash
|
|
56
58
|
starwork init \
|
|
57
59
|
--type single-matter \
|
|
58
60
|
--pack general \
|
|
61
|
+
--language zh \
|
|
59
62
|
--name "StarWork A Test" \
|
|
60
63
|
--target ~/Desktop/starwork-a-test \
|
|
61
64
|
--yes
|
|
62
65
|
```
|
|
63
66
|
|
|
64
|
-
|
|
67
|
+
检查工作台:
|
|
65
68
|
|
|
66
69
|
```bash
|
|
67
70
|
starwork doctor --target ~/Desktop/starwork-a-test
|
|
68
71
|
```
|
|
69
72
|
|
|
70
|
-
|
|
73
|
+
创建一个多项目中枢:
|
|
71
74
|
|
|
72
75
|
```bash
|
|
73
76
|
starwork init \
|
|
74
77
|
--type hub \
|
|
78
|
+
--language zh \
|
|
75
79
|
--name "StarWork Hub A Test" \
|
|
76
80
|
--target ~/Desktop/starwork-hub-a-test \
|
|
77
81
|
--yes
|
|
78
82
|
```
|
|
79
83
|
|
|
80
|
-
|
|
84
|
+
从 Hub 生成一个项目:
|
|
81
85
|
|
|
82
86
|
```bash
|
|
83
87
|
starwork spawn \
|
|
@@ -88,13 +92,13 @@ starwork spawn \
|
|
|
88
92
|
--yes
|
|
89
93
|
```
|
|
90
94
|
|
|
91
|
-
|
|
95
|
+
检查生成的项目:
|
|
92
96
|
|
|
93
97
|
```bash
|
|
94
98
|
starwork doctor --target ~/Desktop/starwork-alpha-project
|
|
95
99
|
```
|
|
96
100
|
|
|
97
|
-
## CLI
|
|
101
|
+
## CLI 能力
|
|
98
102
|
|
|
99
103
|
```text
|
|
100
104
|
starwork init
|
|
@@ -104,49 +108,49 @@ starwork adapt
|
|
|
104
108
|
starwork pack install
|
|
105
109
|
```
|
|
106
110
|
|
|
107
|
-
|
|
111
|
+
当前能力:
|
|
108
112
|
|
|
109
|
-
- `init
|
|
110
|
-
- `doctor
|
|
111
|
-
- `spawn
|
|
112
|
-
- `adapt
|
|
113
|
-
- `pack install
|
|
113
|
+
- `init`:创建轻量单项目、长期事项型单项目或多项目 Hub。
|
|
114
|
+
- `doctor`:检查工作台健康状态、必需文件、Pack 落地结果和 blueprint 定制结果。
|
|
115
|
+
- `spawn`:从已有 Hub 创建并登记卫星项目。
|
|
116
|
+
- `adapt`:生成 Claude Code、Cursor 等 Agent 的适配文件。
|
|
117
|
+
- `pack install`:向兼容工作台安装支持的 Pack。
|
|
114
118
|
|
|
115
|
-
##
|
|
119
|
+
## 仓库结构
|
|
116
120
|
|
|
117
121
|
```text
|
|
118
122
|
.
|
|
119
|
-
├── core/ # StarWork Core
|
|
120
|
-
├── cli/ # CLI
|
|
121
|
-
├── packs/ #
|
|
123
|
+
├── core/ # StarWork Core 协议、Kit、Profile、Preset
|
|
124
|
+
├── cli/ # CLI 实现和命令规格
|
|
125
|
+
├── packs/ # 场景 Pack
|
|
122
126
|
├── skills/ # Agent skills
|
|
123
|
-
├── schemas/ #
|
|
124
|
-
├── adapters/ # Agent
|
|
125
|
-
├── examples/ #
|
|
126
|
-
└── docs/ #
|
|
127
|
+
├── schemas/ # 结构化 schema
|
|
128
|
+
├── adapters/ # Agent 适配规则
|
|
129
|
+
├── examples/ # 示例
|
|
130
|
+
└── docs/ # 产品文档和 A 测指南
|
|
127
131
|
```
|
|
128
132
|
|
|
129
|
-
## A
|
|
133
|
+
## A 测反馈重点
|
|
130
134
|
|
|
131
|
-
|
|
135
|
+
请优先反馈:
|
|
132
136
|
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
137
|
+
- CLI 是否能顺利安装和运行。
|
|
138
|
+
- `init` 创建的工作台结构是否容易理解。
|
|
139
|
+
- `doctor` 的检查结果是否能指导修复问题。
|
|
140
|
+
- Hub + Satellite 工作流是否自然。
|
|
141
|
+
- `starworkInit` 和 `starworkSpawn` 是否能被 Agent 正确识别和调用。
|
|
138
142
|
|
|
139
|
-
|
|
143
|
+
更完整的测试脚本见 [A 测安装指南](docs/alpha-test-guide.md)。
|
|
140
144
|
|
|
141
|
-
##
|
|
145
|
+
## 开发
|
|
142
146
|
|
|
143
|
-
|
|
147
|
+
运行测试:
|
|
144
148
|
|
|
145
149
|
```bash
|
|
146
150
|
npm test
|
|
147
151
|
```
|
|
148
152
|
|
|
149
|
-
|
|
153
|
+
预览 npm 包内容:
|
|
150
154
|
|
|
151
155
|
```bash
|
|
152
156
|
npm pack --dry-run
|
package/docs/README.md
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
这里存放正式产品文档、规格说明、发布说明和对外说明。
|
|
4
4
|
|
|
5
5
|
- [product-direction.md](product-direction.md):StarWork 产品方向、四层结构和关键约束
|
|
6
|
+
- [agent-install-guide.md](agent-install-guide.md):面向用户 Agent 的 StarWork CLI 与 Skills 安装指导
|
|
6
7
|
- [alpha-test-guide.md](alpha-test-guide.md):StarWork A 测 CLI 与 Skills 安装、测试和反馈指南
|
|
7
8
|
- [index.html](index.html):StarWork HTML 文档中心,统一挂载所有 HTML 阅读稿
|
|
8
9
|
- [hub-management.html](hub-management.html):多项目中枢管理机制 HTML 阅读版,解释 Hub + Satellite、项目注册表和回写边界
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# 让 Agent 帮你安装 StarWork
|
|
2
|
+
|
|
3
|
+
这份文档给不想自己敲命令的用户使用。你可以把下面的提示词直接发给 Codex、Claude Code 或其他能操作终端的 Agent,让它帮你完成 StarWork CLI 和 Skills 的安装与验证。
|
|
4
|
+
|
|
5
|
+
## 复制给 Agent 的提示词
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
请帮我安装并验证 StarWork。
|
|
9
|
+
|
|
10
|
+
目标:
|
|
11
|
+
1. 安装 StarWork CLI。
|
|
12
|
+
2. 安装 StarWork 的 Agent skills。
|
|
13
|
+
3. 验证 CLI 和 skills 是否可用。
|
|
14
|
+
4. 不要覆盖我机器上已有的重要文件。如果发现已有 starwork 命令或旧版本,请先告诉我原因和建议,不要直接强制覆盖。
|
|
15
|
+
|
|
16
|
+
请按以下步骤执行:
|
|
17
|
+
|
|
18
|
+
1. 检查 Node.js 和 npm 是否可用:
|
|
19
|
+
node --version
|
|
20
|
+
npm --version
|
|
21
|
+
|
|
22
|
+
2. 检查当前是否已有 starwork 命令:
|
|
23
|
+
which starwork
|
|
24
|
+
starwork --help
|
|
25
|
+
|
|
26
|
+
3. 如果没有 starwork,安装 CLI:
|
|
27
|
+
npm install -g @jennie-shawn/starwork
|
|
28
|
+
|
|
29
|
+
如果已经有 starwork,请判断它是否来自 @jennie-shawn/starwork。
|
|
30
|
+
如果不是,请先向我说明,不要直接覆盖。
|
|
31
|
+
|
|
32
|
+
4. 验证 CLI:
|
|
33
|
+
starwork --help
|
|
34
|
+
npx @jennie-shawn/starwork --help
|
|
35
|
+
|
|
36
|
+
5. 安装 StarWork skills 到 Codex:
|
|
37
|
+
npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y
|
|
38
|
+
|
|
39
|
+
6. 验证 skills 能被发现:
|
|
40
|
+
npx skills add jennie-shawn/starwork --list
|
|
41
|
+
npx skills ls -g -a codex --json
|
|
42
|
+
|
|
43
|
+
7. 做一个最小 CLI 测试,使用临时目录,不要污染我的真实项目:
|
|
44
|
+
rm -rf /tmp/starwork-a-test
|
|
45
|
+
starwork init --type single-matter --pack general --language zh --name "StarWork A Test" --target /tmp/starwork-a-test --yes
|
|
46
|
+
starwork doctor --target /tmp/starwork-a-test
|
|
47
|
+
|
|
48
|
+
完成后请告诉我:
|
|
49
|
+
- StarWork CLI 安装版本。
|
|
50
|
+
- starwork --help 是否可用。
|
|
51
|
+
- starworkInit 和 starworkSpawn 是否已安装。
|
|
52
|
+
- 最小工作台 doctor 是否通过。
|
|
53
|
+
- 如果有任何失败,请贴出关键错误信息和建议处理方式。
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## 手动安装命令
|
|
57
|
+
|
|
58
|
+
如果你想自己安装,也可以直接运行:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
npm install -g @jennie-shawn/starwork
|
|
62
|
+
starwork --help
|
|
63
|
+
npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## 常见情况
|
|
67
|
+
|
|
68
|
+
### 已经存在 `starwork` 命令
|
|
69
|
+
|
|
70
|
+
如果安装时报:
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
EEXIST: file already exists ... starwork
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
说明你的机器上已经有一个 `starwork` 命令。先检查它来自哪里:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
which starwork
|
|
80
|
+
ls -l "$(which starwork)"
|
|
81
|
+
npm ls -g --depth=0 | grep starwork
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
确认后再决定是否卸载旧版本或覆盖安装。
|
|
85
|
+
|
|
86
|
+
### 只想临时测试,不想全局安装
|
|
87
|
+
|
|
88
|
+
可以使用:
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
npx @jennie-shawn/starwork --help
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
如果要在临时目录里测试全局安装,可以指定 prefix:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
rm -rf /tmp/starwork-global-test
|
|
98
|
+
npm install -g @jennie-shawn/starwork --prefix /tmp/starwork-global-test
|
|
99
|
+
/tmp/starwork-global-test/bin/starwork --help
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### 更新 StarWork skills
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
npx skills update starworkInit -g
|
|
106
|
+
npx skills update starworkSpawn -g
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
也可以重新安装:
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y
|
|
113
|
+
```
|
package/docs/alpha-test-guide.md
CHANGED
|
@@ -51,6 +51,7 @@ npx skills add jennie-shawn/starwork --skill starworkSpawn -g -a codex -y
|
|
|
51
51
|
starwork init \
|
|
52
52
|
--type single-matter \
|
|
53
53
|
--pack general \
|
|
54
|
+
--language zh \
|
|
54
55
|
--name "StarWork A Test" \
|
|
55
56
|
--target ~/Desktop/starwork-a-test \
|
|
56
57
|
--yes
|
|
@@ -67,6 +68,7 @@ starwork doctor --target ~/Desktop/starwork-a-test
|
|
|
67
68
|
```bash
|
|
68
69
|
starwork init \
|
|
69
70
|
--type hub \
|
|
71
|
+
--language zh \
|
|
70
72
|
--name "StarWork Hub A Test" \
|
|
71
73
|
--target ~/Desktop/starwork-hub-a-test \
|
|
72
74
|
--yes
|
|
@@ -42,16 +42,16 @@ Core v0.1 协议
|
|
|
42
42
|
↓
|
|
43
43
|
CLI v0.1 安装与适配
|
|
44
44
|
↓
|
|
45
|
-
|
|
45
|
+
内容创作者 Pack v0.1
|
|
46
46
|
↓
|
|
47
47
|
Demo 工作区与产品文档
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
目标是证明:普通内容创作者可以安装 StarWork
|
|
50
|
+
目标是证明:普通内容创作者可以安装 StarWork,加入内容创作者 Pack,并让 Agent 清楚知道灵感、选题、草稿、发布记录、复盘数据、用户反馈和下一步动作分别放在哪里。
|
|
51
51
|
|
|
52
52
|
## v0.1 当前收敛
|
|
53
53
|
|
|
54
|
-
截至 2026-05-
|
|
54
|
+
截至 2026-05-19,Core 被定义为开源 AI 工作区协议;Kit 是协议的参考落地结构;CLI 负责稳定生成、检查、适配和安装 Pack;Skill 负责帮助 Agent 生成配置、理解流程和调用工具;Pack 负责场景定制。
|
|
55
55
|
|
|
56
56
|
当前已经形成:
|
|
57
57
|
|
|
@@ -59,6 +59,8 @@ Demo 工作区与产品文档
|
|
|
59
59
|
- `starwork init`、`starwork spawn`、`starwork doctor`、`starwork adapt`、`starwork pack install` 第一版。
|
|
60
60
|
- `starwork spawn --blueprint` 第一版,可按工作台定制单生成定制化卫星项目。
|
|
61
61
|
- `starworkSpawn` skill 第一版,用于帮助 Agent 设计 Spawn Blueprint。
|
|
62
|
+
- `starworkInit` skill 第一版,用于帮助 Agent 采访用户并生成初始化建议。
|
|
63
|
+
- 公开 A 测分发入口:GitHub `jennie-shawn/starwork` 与 npm `@jennie-shawn/starwork`。
|
|
62
64
|
- Pack 源包结构:语言无关业务角色 + `languages/` 多语言落地配置。
|
|
63
65
|
|
|
64
|
-
下一步重点不是继续扩张 Core
|
|
66
|
+
下一步重点不是继续扩张 Core,而是先验证 CLI 与 Skills 能否被 A 测用户顺利安装和调用;安装链路稳定后,再进入内容创作者 Pack 的场景验证。
|
package/docs/roadmap.html
CHANGED
|
@@ -600,7 +600,7 @@
|
|
|
600
600
|
<text x="44" y="38" text-anchor="middle" font-size="12" fill="#2f6286">稳定</text>
|
|
601
601
|
</g>
|
|
602
602
|
|
|
603
|
-
<text x="36" y="682" font-size="13" fill="#61675f">当前重心:
|
|
603
|
+
<text x="36" y="682" font-size="13" fill="#61675f">当前重心:M2.5 公开 A 测分发与安装验证。</text>
|
|
604
604
|
</svg>
|
|
605
605
|
</div>
|
|
606
606
|
</section>
|
|
@@ -658,6 +658,20 @@
|
|
|
658
658
|
</article>
|
|
659
659
|
|
|
660
660
|
<article class="milestone now">
|
|
661
|
+
<div class="milestone-top">
|
|
662
|
+
<div class="code">M2.5</div>
|
|
663
|
+
<span class="status">进行中</span>
|
|
664
|
+
</div>
|
|
665
|
+
<h3>公开 A 测分发</h3>
|
|
666
|
+
<p>让外部用户可以通过 GitHub、npm 和 skills 命令安装并验证最小流程。</p>
|
|
667
|
+
<ul>
|
|
668
|
+
<li>CLI 公开安装</li>
|
|
669
|
+
<li>Skills 公开安装</li>
|
|
670
|
+
<li>init / doctor / spawn 最小流程</li>
|
|
671
|
+
</ul>
|
|
672
|
+
</article>
|
|
673
|
+
|
|
674
|
+
<article class="milestone future">
|
|
661
675
|
<div class="milestone-top">
|
|
662
676
|
<div class="code">M3</div>
|
|
663
677
|
<span class="status">下一阶段</span>
|
|
@@ -751,30 +765,30 @@
|
|
|
751
765
|
|
|
752
766
|
<div class="focus-layout">
|
|
753
767
|
<div class="focus-copy">
|
|
754
|
-
<h3>进入
|
|
768
|
+
<h3>进入 M2.5:公开 A 测分发</h3>
|
|
755
769
|
<p>
|
|
756
770
|
CLI v0.1 最小闭环已经完成,StarWork 现在具备了生成、检查、适配和补装 Pack 的基本工具链。
|
|
757
771
|
</p>
|
|
758
772
|
<p>
|
|
759
|
-
|
|
773
|
+
现在要先确认外部用户能从公开入口安装 CLI 与 Skills,并跑通 <code>init</code>、<code>doctor</code>、<code>spawn</code> 的最小流程。
|
|
760
774
|
</p>
|
|
761
775
|
<p>
|
|
762
|
-
|
|
776
|
+
内容创作者 Pack 仍是下一阶段的场景验证方向,但它应该等安装链路稳定后再启动。
|
|
763
777
|
</p>
|
|
764
778
|
|
|
765
779
|
<div class="priority" aria-label="下一步优先级">
|
|
766
780
|
<div class="priority-item">
|
|
767
781
|
<div class="priority-number">1</div>
|
|
768
782
|
<div>
|
|
769
|
-
<b
|
|
770
|
-
<span
|
|
783
|
+
<b>确认 alpha.3 发布</b>
|
|
784
|
+
<span>让 npm <code>latest</code> 从 <code>0.1.0-alpha.2</code> 更新到本地已准备的 <code>0.1.0-alpha.3</code>。</span>
|
|
771
785
|
</div>
|
|
772
786
|
</div>
|
|
773
787
|
<div class="priority-item">
|
|
774
788
|
<div class="priority-number">2</div>
|
|
775
789
|
<div>
|
|
776
|
-
<b
|
|
777
|
-
<span
|
|
790
|
+
<b>收集 A 测反馈</b>
|
|
791
|
+
<span>观察 CLI 安装、Skills 安装、<code>init</code>、<code>doctor</code>、<code>spawn</code> 是否真的顺。</span>
|
|
778
792
|
</div>
|
|
779
793
|
</div>
|
|
780
794
|
</div>
|
|
@@ -783,7 +797,7 @@
|
|
|
783
797
|
<div class="focus-svg" aria-label="当前优先级依赖图">
|
|
784
798
|
<svg viewBox="0 0 640 440" role="img" aria-labelledby="focus-svg-title focus-svg-desc">
|
|
785
799
|
<title id="focus-svg-title">当前工作依赖图</title>
|
|
786
|
-
<desc id="focus-svg-desc">Core 和 CLI
|
|
800
|
+
<desc id="focus-svg-desc">Core 和 CLI 最小闭环已经形成,下一步先完成公开 A 测安装验证,再进入内容创作者 Pack。</desc>
|
|
787
801
|
<defs>
|
|
788
802
|
<marker id="arrow2" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
|
|
789
803
|
<path d="M 0 0 L 10 5 L 0 10 z" fill="#3e473e"></path>
|
|
@@ -863,7 +877,7 @@
|
|
|
863
877
|
<div class="release-block">
|
|
864
878
|
<h3>v0.1 要交付什么</h3>
|
|
865
879
|
<p>
|
|
866
|
-
Core v0.1 协议、CLI v0.1、General Pack、Hub Management Pack
|
|
880
|
+
Core v0.1 协议、CLI v0.1、General Pack、Hub Management Pack、公开 A 测安装文档、Content Creator Pack v0.1、Demo 工作区和入门文档。
|
|
867
881
|
</p>
|
|
868
882
|
<div class="tag-list">
|
|
869
883
|
<span>Core</span>
|
|
@@ -877,7 +891,7 @@
|
|
|
877
891
|
<div class="release-block">
|
|
878
892
|
<h3>v0.1 怎么算成功</h3>
|
|
879
893
|
<p>
|
|
880
|
-
用户能知道 StarWork
|
|
894
|
+
用户能知道 StarWork 是什么,能按文档安装 CLI 与 Skills,能初始化一个工作台,能理解 Core、Kit、CLI、Pack 的关系,并能用 Content Creator Pack 跑一次最小内容生产闭环。
|
|
881
895
|
</p>
|
|
882
896
|
<div class="tag-list">
|
|
883
897
|
<span>能看懂</span>
|
package/docs/roadmap.md
CHANGED
|
@@ -21,7 +21,7 @@ StarWork 现在不缺想法,缺的是一条清晰的主线。
|
|
|
21
21
|
- `starwork pack install` 第一版已经可以在健康工作台上补装 Pack。
|
|
22
22
|
- `starwork spawn --blueprint` 第一版已经可以按工作台定制单生成定制化卫星项目;`starworkSpawn` skill 第一版用于生成工作台定制单。
|
|
23
23
|
|
|
24
|
-
所以,下一步不应该继续扩张 Core 或 CLI
|
|
24
|
+
所以,下一步不应该继续扩张 Core 或 CLI。当前应先完成公开 A 测分发和安装反馈收集,再进入第一个场景 Pack 与 Demo 验证。
|
|
25
25
|
|
|
26
26
|
## 总路线
|
|
27
27
|
|
|
@@ -32,6 +32,8 @@ M1 Core v0.1 封版
|
|
|
32
32
|
↓
|
|
33
33
|
M2 CLI v0.1 最小闭环
|
|
34
34
|
↓
|
|
35
|
+
M2.5 公开 A 测分发与安装验证
|
|
36
|
+
↓
|
|
35
37
|
M3 Content Creator Pack v0.1
|
|
36
38
|
↓
|
|
37
39
|
M4 Demo 工作区
|
|
@@ -121,9 +123,31 @@ M8 v1.0 稳定产品
|
|
|
121
123
|
- 用户可以为当前 Agent 生成或更新适配文件。
|
|
122
124
|
- 用户可以安装或更新 Pack,并且不会覆盖已有内容。
|
|
123
125
|
|
|
126
|
+
## M2.5 公开 A 测分发与安装验证
|
|
127
|
+
|
|
128
|
+
状态:进行中。
|
|
129
|
+
|
|
130
|
+
目标:让外部 A 测用户可以通过公开 GitHub 与 npm 入口安装 StarWork,并验证 CLI 与 Skills 的最小流程。
|
|
131
|
+
|
|
132
|
+
当前成果:
|
|
133
|
+
|
|
134
|
+
- GitHub 仓库已推送到 `jennie-shawn/starwork`。
|
|
135
|
+
- npm 包名为 `@jennie-shawn/starwork`。
|
|
136
|
+
- `starworkInit` 与 `starworkSpawn` 可通过 `npx skills add jennie-shawn/starwork --skill '*' -g -a codex -y` 安装。
|
|
137
|
+
- 公开 README 已改为中文首页。
|
|
138
|
+
- 已新增面向 Agent 的安装指南:`product/docs/agent-install-guide.md`。
|
|
139
|
+
- 本地产品仓库已准备 `0.1.0-alpha.3`;清理时 npm `latest` 仍是 `0.1.0-alpha.2`,需要手动发布后再确认。
|
|
140
|
+
|
|
141
|
+
验收标准:
|
|
142
|
+
|
|
143
|
+
- A 测用户能安装 CLI 并看到 `starwork --help`。
|
|
144
|
+
- A 测用户能安装 Skills,并让 Agent 识别 `starworkInit` 与 `starworkSpawn`。
|
|
145
|
+
- `init -> doctor -> hub init -> spawn -> doctor` 的最小流程能被外部用户跑通。
|
|
146
|
+
- A 测反馈中暴露的安装和 skill 调用问题被记录到 matter。
|
|
147
|
+
|
|
124
148
|
## M3 Content Creator Pack v0.1
|
|
125
149
|
|
|
126
|
-
|
|
150
|
+
状态:下一阶段,等待 A 测安装链路稳定后启动。
|
|
127
151
|
|
|
128
152
|
目标:做出第一个真正能解决场景问题的 Pack,而不是只有目录结构。
|
|
129
153
|
|
|
@@ -147,7 +171,7 @@ Pack 应覆盖的最小内容闭环:
|
|
|
147
171
|
|
|
148
172
|
还需要做:
|
|
149
173
|
|
|
150
|
-
-
|
|
174
|
+
- 创建内容创作者 Pack v0.1 matter。
|
|
151
175
|
- 确认目录结构。
|
|
152
176
|
- 确认每个目录下的 Agent 规则。
|
|
153
177
|
- 确认模板和 seed 示例。
|
|
@@ -262,11 +286,12 @@ v1.0 应具备:
|
|
|
262
286
|
|
|
263
287
|
## 当前下一步
|
|
264
288
|
|
|
265
|
-
当前最应该做的不是重开 Core 或继续扩张 CLI
|
|
289
|
+
当前最应该做的不是重开 Core 或继续扩张 CLI,而是先完成 M2.5:
|
|
266
290
|
|
|
267
|
-
1.
|
|
268
|
-
2.
|
|
291
|
+
1. 手动发布并验证 `@jennie-shawn/starwork@0.1.0-alpha.3`。
|
|
292
|
+
2. 收集 A 测用户对 CLI 安装、Skills 安装、`init`、`doctor`、`spawn` 的反馈。
|
|
293
|
+
3. 安装链路稳定后,新建 Content Creator Pack v0.1 matter,把首个场景 Pack 的目录、规则、模板和 Demo 定下来。
|
|
269
294
|
|
|
270
|
-
|
|
295
|
+
如果只能选一个,先确认 `0.1.0-alpha.3` 已经成为 npm `latest` 并跑通公开安装。
|
|
271
296
|
|
|
272
|
-
原因:M2 已经提供了最小 CLI
|
|
297
|
+
原因:M2 已经提供了最小 CLI 工具链,但外部用户能否顺利安装和调用 Skills,是进入场景 Pack 前必须先压实的入口问题。
|
package/docs/v0.1-plan.md
CHANGED
|
@@ -19,7 +19,7 @@ StarWork v0.1 采用三条线并行推进。
|
|
|
19
19
|
- 哪些动作需要用户确认?
|
|
20
20
|
- 多个 Agent 如何共享同一工作区上下文?
|
|
21
21
|
|
|
22
|
-
Core 必须保持跨行业、跨场景、跨 Agent
|
|
22
|
+
Core 必须保持跨行业、跨场景、跨 Agent,不混入内容创作者 Pack 的专属逻辑。
|
|
23
23
|
|
|
24
24
|
### CLI v0.1
|
|
25
25
|
|
|
@@ -39,6 +39,13 @@ starwork pack install content-creator
|
|
|
39
39
|
|
|
40
40
|
CLI 在安装、生成或更新时必须保护用户已有内容。它可以生成或更新 Agent 适配文件,也可以从 Hub 生成新项目工作台,但不能覆盖项目事实源。
|
|
41
41
|
|
|
42
|
+
公开 A 测状态:
|
|
43
|
+
|
|
44
|
+
- GitHub 仓库为 `jennie-shawn/starwork`。
|
|
45
|
+
- npm 包为 `@jennie-shawn/starwork`。
|
|
46
|
+
- `starworkInit` 与 `starworkSpawn` 已可通过 `npx skills add jennie-shawn/starwork` 安装。
|
|
47
|
+
- 本地产品仓库已准备 `0.1.0-alpha.3`,npm `latest` 仍需发布确认后从 `0.1.0-alpha.2` 更新。
|
|
48
|
+
|
|
42
49
|
M2 完成后新增的定制生成方向:
|
|
43
50
|
|
|
44
51
|
- `starwork spawn --blueprint` 第一版已落地,用于让 CLI 按工作台定制单生成定制化卫星项目。
|
|
@@ -53,9 +60,9 @@ Pack 选择 -> Pack 语言配置
|
|
|
53
60
|
Kit 文件 + Pack 规则 / seed / templates -> 最终工作台
|
|
54
61
|
```
|
|
55
62
|
|
|
56
|
-
###
|
|
63
|
+
### 内容创作者 Pack v0.1
|
|
57
64
|
|
|
58
|
-
|
|
65
|
+
目标:提供首个面向内容创作者的完整场景工作流包。
|
|
59
66
|
|
|
60
67
|
Pack 应覆盖:
|
|
61
68
|
|
|
@@ -103,7 +110,7 @@ seed/<language>/
|
|
|
103
110
|
|
|
104
111
|
1. Core v0.1 协议草案:已封版
|
|
105
112
|
2. CLI v0.1 命令边界:已完成最小闭环,`init`、`spawn`、`doctor`、`adapt`、`pack install` 第一版已落地
|
|
106
|
-
3.
|
|
113
|
+
3. 内容创作者 Pack v0.1 MVP 范围
|
|
107
114
|
4. 旧 Runtime spike 复核
|
|
108
115
|
|
|
109
116
|
这些事项中的成熟草案再晋升到 `product/`。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@jennie-shawn/starwork",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
4
|
-
"description": "StarWork Core
|
|
3
|
+
"version": "0.1.0-alpha.3",
|
|
4
|
+
"description": "StarWork Core、CLI、Packs 和 Agent skills,用于构建 AI 工作台。",
|
|
5
5
|
"type": "commonjs",
|
|
6
6
|
"bin": {
|
|
7
7
|
"starwork": "cli/bin/starwork.js"
|