@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 CHANGED
@@ -1,83 +1,87 @@
1
1
  # StarWork
2
2
 
3
- StarWork is an AI workspace protocol and toolkit for keeping long-running work organized across agents, projects, and sessions.
3
+ StarWork 是一套面向 AI Agent 的工作台协议和工具集,用来帮助用户把长期工作、跨会话协作、多项目管理和 Agent 工作流组织清楚。
4
4
 
5
- It provides:
5
+ 它包含四个核心部分:
6
6
 
7
- - **Core**: workspace structures, roles, health checks, and project-state conventions.
8
- - **CLI**: commands for creating, checking, adapting, extending, and spawning workspaces.
9
- - **Packs**: scenario templates for common workflows.
10
- - **Skills**: Agent workflows that help Codex and other agents design StarWork workspaces.
7
+ - **Core**:定义工作台应该长什么样,包括目录结构、角色边界、状态文件和健康检查规则。
8
+ - **CLI**:提供 `init`、`doctor`、`spawn`、`adapt`、`pack install` 等命令,用来创建、检查和扩展工作台。
9
+ - **Packs**:场景模板包。当前 A 测阶段默认使用通用 Pack。
10
+ - **Skills**:给 Codex Agent 使用的工作流说明,让 Agent 能更可靠地帮用户设计和生成 StarWork 工作台。
11
11
 
12
- StarWork is currently in early A-test. The current package is intended for installation testing, workflow validation, and product feedback.
12
+ 当前版本处于 A 测阶段,适合测试安装流程、基础命令、工作台结构和 Agent skill 使用体验。
13
13
 
14
- ## Install
14
+ ## 安装 CLI
15
15
 
16
- Install the CLI globally:
16
+ 全局安装:
17
17
 
18
18
  ```bash
19
19
  npm install -g @jennie-shawn/starwork
20
20
  starwork --help
21
21
  ```
22
22
 
23
- Or run it without global installation:
23
+ 不全局安装,直接运行:
24
24
 
25
25
  ```bash
26
26
  npx @jennie-shawn/starwork --help
27
27
  ```
28
28
 
29
- ## Install Skills
29
+ ## 安装 Skills
30
30
 
31
- StarWork skills are distributed through the `skills` CLI from the GitHub repository.
31
+ StarWork skills 通过 GitHub 仓库和 `skills` CLI 分发。
32
32
 
33
- Install all StarWork skills for Codex:
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
- Install individual skills:
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
- Available skills:
46
+ 当前 skills
47
47
 
48
- - `starworkInit`: helps an agent design a friendly `starwork init` plan for a new workspace.
49
- - `starworkSpawn`: helps an agent design a `starwork spawn --blueprint` plan for a satellite workspace.
48
+ - `starworkInit`:帮助 Agent 判断工作台类型、语言、是否需要事项,并生成友好的 `starwork init` 初始化方案。
49
+ - `starworkSpawn`:帮助 Agent 为已有 Hub 设计 `starwork spawn --blueprint` 工作台定制单。
50
50
 
51
- ## Quick Start
51
+ 如果你希望让 Agent 帮你完成安装,可以把 [Agent 安装指南](docs/agent-install-guide.md) 里的提示词发给你的 Agent。
52
52
 
53
- Create a single-project workspace:
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
- Check the workspace:
67
+ 检查工作台:
65
68
 
66
69
  ```bash
67
70
  starwork doctor --target ~/Desktop/starwork-a-test
68
71
  ```
69
72
 
70
- Create a multi-project Hub:
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
- Spawn a project from the Hub:
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
- Check the spawned project:
95
+ 检查生成的项目:
92
96
 
93
97
  ```bash
94
98
  starwork doctor --target ~/Desktop/starwork-alpha-project
95
99
  ```
96
100
 
97
- ## CLI Commands
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
- Current capabilities:
111
+ 当前能力:
108
112
 
109
- - `init`: creates a local starter workspace, local matter workspace, or multi-project Hub.
110
- - `doctor`: checks workspace health, required files, Pack installation, and blueprint customization.
111
- - `spawn`: creates and registers a satellite project from an existing Hub.
112
- - `adapt`: generates Agent-specific adapter files for Claude Code, Cursor, and related tools.
113
- - `pack install`: installs supported Packs into compatible workspaces.
113
+ - `init`:创建轻量单项目、长期事项型单项目或多项目 Hub
114
+ - `doctor`:检查工作台健康状态、必需文件、Pack 落地结果和 blueprint 定制结果。
115
+ - `spawn`:从已有 Hub 创建并登记卫星项目。
116
+ - `adapt`:生成 Claude CodeCursor Agent 的适配文件。
117
+ - `pack install`:向兼容工作台安装支持的 Pack。
114
118
 
115
- ## Repository Structure
119
+ ## 仓库结构
116
120
 
117
121
  ```text
118
122
  .
119
- ├── core/ # StarWork Core protocol, kits, profiles, and presets
120
- ├── cli/ # CLI implementation and command specifications
121
- ├── packs/ # Scenario Packs
123
+ ├── core/ # StarWork Core 协议、Kit、Profile、Preset
124
+ ├── cli/ # CLI 实现和命令规格
125
+ ├── packs/ # 场景 Pack
122
126
  ├── skills/ # Agent skills
123
- ├── schemas/ # Structured schemas
124
- ├── adapters/ # Agent adapter rules
125
- ├── examples/ # Examples and sample snippets
126
- └── docs/ # Product documentation and A-test guides
127
+ ├── schemas/ # 结构化 schema
128
+ ├── adapters/ # Agent 适配规则
129
+ ├── examples/ # 示例
130
+ └── docs/ # 产品文档和 A 测指南
127
131
  ```
128
132
 
129
- ## A-test Notes
133
+ ## A 测反馈重点
130
134
 
131
- This release is intended for early testers. Please focus feedback on:
135
+ 请优先反馈:
132
136
 
133
- - whether the CLI installs and runs cleanly;
134
- - whether generated workspace structures are easy to understand;
135
- - whether `doctor` explains problems clearly;
136
- - whether Hub + Satellite workflows feel natural;
137
- - whether `starworkInit` and `starworkSpawn` can be discovered and used by Codex.
137
+ - CLI 是否能顺利安装和运行。
138
+ - `init` 创建的工作台结构是否容易理解。
139
+ - `doctor` 的检查结果是否能指导修复问题。
140
+ - Hub + Satellite 工作流是否自然。
141
+ - `starworkInit` `starworkSpawn` 是否能被 Agent 正确识别和调用。
138
142
 
139
- For a fuller test script, see [docs/alpha-test-guide.md](docs/alpha-test-guide.md).
143
+ 更完整的测试脚本见 [A 测安装指南](docs/alpha-test-guide.md)
140
144
 
141
- ## Development
145
+ ## 开发
142
146
 
143
- Run the test suite:
147
+ 运行测试:
144
148
 
145
149
  ```bash
146
150
  npm test
147
151
  ```
148
152
 
149
- Preview the npm package contents:
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
+ ```
@@ -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
- 自媒体内容创作者 Pack v0.1
45
+ 内容创作者 Pack v0.1
46
46
 
47
47
  Demo 工作区与产品文档
48
48
  ```
49
49
 
50
- 目标是证明:普通内容创作者可以安装 StarWork,加入自媒体内容创作者 Pack,并让 Agent 清楚知道灵感、选题、草稿、发布记录、复盘数据、用户反馈和下一步动作分别放在哪里。
50
+ 目标是证明:普通内容创作者可以安装 StarWork,加入内容创作者 Pack,并让 Agent 清楚知道灵感、选题、草稿、发布记录、复盘数据、用户反馈和下一步动作分别放在哪里。
51
51
 
52
52
  ## v0.1 当前收敛
53
53
 
54
- 截至 2026-05-18,Core 被定义为开源 AI 工作区协议;Kit 是协议的参考落地结构;CLI 负责稳定生成、检查、适配和安装 Pack;Skill 负责帮助 Agent 生成配置、理解流程和调用工具;Pack 负责场景定制。
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,而是验证 CLI、Skill Pack 能否在真实场景里稳定生成、检查、安装和解释这些结构。
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">当前重心:M3 Content Creator Pack v0.1。</text>
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>进入 M3:首个场景 Pack</h3>
768
+ <h3>进入 M2.5:公开 A 测分发</h3>
755
769
  <p>
756
770
  CLI v0.1 最小闭环已经完成,StarWork 现在具备了生成、检查、适配和补装 Pack 的基本工具链。
757
771
  </p>
758
772
  <p>
759
- M2 之后新增了一条定制生成线索:<code>starworkSpawn</code> skill 负责生成工作台定制单,<code>spawn --blueprint</code> 已能按定制单创建卫星项目。
773
+ 现在要先确认外部用户能从公开入口安装 CLI 与 Skills,并跑通 <code>init</code>、<code>doctor</code>、<code>spawn</code> 的最小流程。
760
774
  </p>
761
775
  <p>
762
- 下一步要把工具链放进真实场景里检验:用 Content Creator Pack 跑出一个能被用户理解、能被 Agent 接力的内容生产工作台。
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>新建 Content Creator Pack matter</b>
770
- <span>把首个场景 Pack 的目录、规则、模板和 Demo 定下来。</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>生成 Demo 工作区</b>
777
- <span>验证 <code>init</code>、<code>doctor</code>、<code>adapt</code>、<code>pack install</code> 是否真的顺。</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 最小闭环已经形成,下一步进入 Content Creator Pack 和 Demo 工作区验证。</desc>
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 PackContent Creator Pack v0.1、Demo 工作区和入门文档。
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 是什么,能按文档初始化一个工作台,能理解 Core、Kit、CLI、Pack 的关系,并能用 Content Creator Pack 跑一次最小内容生产闭环。
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,而应该进入第一个场景 Pack 与 Demo 验证。
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
- - 创建自媒体内容创作者 Pack v0.1 matter。
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,而是进入 M3
289
+ 当前最应该做的不是重开 Core 或继续扩张 CLI,而是先完成 M2.5
266
290
 
267
- 1. 新建 Content Creator Pack v0.1 matter:把首个场景 Pack 的目录、规则、模板和 Demo 定下来。
268
- 2. 用已完成的 CLI 最小闭环生成 Demo 工作区,验证 `init -> doctor -> adapt -> pack install` 是否真的顺。
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
- 如果只能选一个,先做 Content Creator Pack v0.1 matter。
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,不混入自媒体内容创作者 Pack 的专属逻辑。
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
- ### 自媒体内容创作者 Pack v0.1
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. 自媒体内容创作者 Pack v0.1 MVP 范围
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.2",
4
- "description": "StarWork Core, CLI, Packs, and Agent skills for AI workspaces.",
3
+ "version": "0.1.0-alpha.3",
4
+ "description": "StarWork CoreCLIPacks Agent skills,用于构建 AI 工作台。",
5
5
  "type": "commonjs",
6
6
  "bin": {
7
7
  "starwork": "cli/bin/starwork.js"