@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.21

package/docs/roadmap.html

@@ -524,11 +524,11 @@
           </div>
           <div class="answer">
             <b>正在推进</b>
-            <span>CLI v0.1 最小闭环已完成，进入首个场景 Pack。</span>
+            <span>公开 A 测基线已形成，正在进入 M2.6 既有功能优化与稳定化。</span>
           </div>
           <div class="answer">
             <b>不要跑偏</b>
-            <span>先跑通生成、检查、适配、Pack 安装，再扩张能力。</span>
+            <span>先跑通安装、检查、升级和 Skill 分发，再扩张场景能力。</span>
           </div>
         </div>
       </div>
@@ -536,7 +536,7 @@
       <div class="hero-map" aria-label="StarWork 里程碑总路线图">
         <svg viewBox="0 0 560 720" role="img" aria-labelledby="roadmap-title roadmap-desc">
           <title id="roadmap-title">StarWork 从 M0 到 M8 的路线图</title>
-          <desc id="roadmap-desc">M0 已完成，M1 已封版，M2 已完成，M3 正在进行，M4 到 M8 待推进。</desc>
+          <desc id="roadmap-desc">M0 已完成，M1 已封版，M2 已完成，M2.6 正在进行，M3 到 M8 待推进。</desc>
           <defs>
             <marker id="arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
               <path d="M 0 0 L 10 5 L 0 10 z" fill="#3e473e"></path>
@@ -571,8 +571,8 @@
           </g>
           <g transform="translate(236 260)">
             <rect width="88" height="48" rx="8" fill="#f3dfbd" stroke="#b36b19" stroke-width="3"></rect>
-            <text x="44" y="21" text-anchor="middle" font-size="14" font-weight="900" fill="#b36b19">M3</text>
-            <text x="44" y="38" text-anchor="middle" font-size="12" fill="#b36b19">进行中</text>
+            <text x="44" y="21" text-anchor="middle" font-size="14" font-weight="900" fill="#b36b19">M2.6</text>
+            <text x="44" y="38" text-anchor="middle" font-size="12" fill="#b36b19">优化中</text>
           </g>
           <g transform="translate(48 308)">
             <rect width="88" height="48" rx="8" fill="#d7e4ea" stroke="#2f6286" stroke-width="2"></rect>
@@ -600,7 +600,7 @@
             <text x="44" y="38" text-anchor="middle" font-size="12" fill="#2f6286">稳定</text>
           </g>
 
-          <text x="36" y="682" font-size="13" fill="#61675f">当前重心：M3 Content Creator Pack v0.1。</text>
+          <text x="36" y="682" font-size="13" fill="#61675f">当前重心：M2.6 既有功能优化与 A 测稳定化。</text>
         </svg>
       </div>
     </section>
@@ -621,7 +621,7 @@
           <p>建立正式产品项目，不再混用课程项目和旧 Runtime spike。</p>
           <ul>
             <li><code>product/</code> 是产品事实源</li>
-            <li><code>matters/</code> 是推进过程</li>
+            <li><code>product/planning/</code> 是规划和验收入口</li>
             <li>Product 仓库已经独立</li>
           </ul>
         </article>
@@ -635,7 +635,7 @@
           <p>最小工作区协议已冻结，后续作为 CLI 检查、适配和 Pack 安装的基础。</p>
           <ul>
             <li>中文协议入口已形成</li>
-            <li>五类 Kit 已收敛</li>
+            <li>Project Kit 与项目中心 Kit 已收敛</li>
             <li>v0.1 不再继续扩张 Core 范围</li>
           </ul>
         </article>
@@ -658,6 +658,20 @@
         </article>
 
         <article class="milestone now">
+          <div class="milestone-top">
+            <div class="code">M2.6</div>
+            <span class="status">进行中</span>
+          </div>
+          <h3>既有功能优化</h3>
+          <p>让已发布的 CLI、Skills、Kit 和文档链路变得稳定、清楚、不误导用户和 Agent。</p>
+          <ul>
+            <li>安装与 A 测文档校准</li>
+            <li>init / doctor / upgrade 链路打磨</li>
+            <li>项目中心管理、Skill 边界和 MultiAgent Codex 链路优化</li>
+          </ul>
+        </article>
+
+        <article class="milestone future">
           <div class="milestone-top">
             <div class="code">M3</div>
             <span class="status">下一阶段</span>
@@ -708,7 +722,7 @@
           <p>发布第一个可被外部理解和试用的 StarWork 版本。</p>
           <ul>
             <li>Core + CLI</li>
-            <li>General / Hub / Content Packs</li>
+            <li>General / Project Center / Content Packs</li>
             <li>Demo 与入门文档</li>
           </ul>
         </article>
@@ -751,30 +765,30 @@
 
       <div class="focus-layout">
         <div class="focus-copy">
-          <h3>进入 M3：首个场景 Pack</h3>
+          <h3>进入 M2.6：既有功能优化</h3>
           <p>
-            CLI v0.1 最小闭环已经完成，StarWork 现在具备了生成、检查、适配和补装 Pack 的基本工具链。
+            CLI v0.1 最小闭环和公开 A 测基线已经完成，StarWork 现在具备了生成、检查、升级、适配、补装 Pack、项目中心巡检修复和分发工作台模板自带 Skill 的基本工具链。
           </p>
           <p>
-            M2 之后新增了一条定制生成线索：<code>starworkSpawn</code> skill 负责生成工作台定制单，<code>spawn --blueprint</code> 已能按定制单创建卫星项目。
+            现在要先把既有链路打磨稳定：安装、<code>init</code>、<code>doctor</code> 到 <code>upgrade</code>、项目中心下 <code>spawn</code> / <code>audit</code> / <code>repair</code>，以及 <code>multiagent launch/read/instruct</code> 的 Codex 多会话协作体验。
           </p>
           <p>
-            下一步要把工具链放进真实场景里检验：用 Content Creator Pack 跑出一个能被用户理解、能被 Agent 接力的内容生产工作台。
+            内容创作者 Pack 仍是下一阶段的场景验证方向，但它应该等 A 测稳定化和 GFM 新一期课程内容一起整理后再启动。
           </p>
 
           <div class="priority" aria-label="下一步优先级">
             <div class="priority-item">
               <div class="priority-number">1</div>
               <div>
-                <b>新建 Content Creator Pack matter</b>
-                <span>把首个场景 Pack 的目录、规则、模板和 Demo 定下来。</span>
+                <b>校准文档与记忆</b>
+                <span>先让版本、阶段、下一步和能力注册表保持一致。</span>
               </div>
             </div>
             <div class="priority-item">
               <div class="priority-number">2</div>
               <div>
-                <b>生成 Demo 工作区</b>
-                <span>验证 <code>init</code>、<code>doctor</code>、<code>adapt</code>、<code>pack install</code> 是否真的顺。</span>
+                <b>优化既有链路</b>
+                <span>重点看历史模板升级、规则文档质量、项目中心管理和 Skill 分发边界。</span>
               </div>
             </div>
           </div>
@@ -783,7 +797,7 @@
         <div class="focus-svg" aria-label="当前优先级依赖图">
           <svg viewBox="0 0 640 440" role="img" aria-labelledby="focus-svg-title focus-svg-desc">
             <title id="focus-svg-title">当前工作依赖图</title>
-            <desc id="focus-svg-desc">Core 和 CLI 最小闭环已经形成，下一步进入 Content Creator Pack 和 Demo 工作区验证。</desc>
+            <desc id="focus-svg-desc">Core、CLI 和公开 A 测基线已经形成，下一步先优化既有链路和文档状态，再进入内容创作者 Pack。</desc>
             <defs>
               <marker id="arrow2" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
                 <path d="M 0 0 L 10 5 L 0 10 z" fill="#3e473e"></path>
@@ -863,7 +877,7 @@
         <div class="release-block">
           <h3>v0.1 要交付什么</h3>
           <p>
-            Core v0.1 协议、CLI v0.1、General Pack、Hub Management Pack、Content Creator Pack v0.1、Demo 工作区和入门文档。
+            Core v0.1 协议、CLI v0.1、General Pack、Project Center Pack、公开 A 测安装文档、Content Creator Pack v0.1、Demo 工作区和入门文档。
           </p>
           <div class="tag-list">
             <span>Core</span>
@@ -877,7 +891,7 @@
         <div class="release-block">
           <h3>v0.1 怎么算成功</h3>
           <p>
-            用户能知道 StarWork 是什么，能按文档初始化一个工作台，能理解 Core、Kit、CLI、Pack 的关系，并能用 Content Creator Pack 跑一次最小内容生产闭环。
+            用户能知道 StarWork 是什么，能按文档安装 CLI 与 Skills，能初始化一个工作台，能理解 Core、Kit、CLI、Pack 的关系，并能用 Content Creator Pack 跑一次最小内容生产闭环。
           </p>
           <div class="tag-list">
             <span>能看懂</span>

package/docs/roadmap.md

@@ -2,7 +2,7 @@
 
 本文用于回答一个问题：StarWork 接下来应该按什么顺序推进。
 
-它不是具体任务清单，而是产品从“能跑起来”到“能发布、能教学、能扩展”的阶段地图。具体任务仍然放在 `matters/` 中推进，成熟结论再进入 `product/`。
+它不是具体任务清单，而是产品从“能跑起来”到“能发布、能教学、能扩展”的阶段地图。功能规划、版本 SPEC、讨论沉淀、参考资料和验收材料统一进入 `product/planning/`。
 
 ## 当前判断
 
@@ -15,13 +15,23 @@ StarWork 现在不缺想法，缺的是一条清晰的主线。
 - CLI 被定义为稳定生成、检查、适配和安装 Pack 的工具。
 - Pack 被定义为场景定制工作流包。
 - `starwork init` 第一版已经可以把 Kit 和 Pack 组装成工作台。
-- `starwork spawn` 第一版已经可以从多项目中枢生成并登记新项目工作台。
+- `starwork spawn` 第一版已经可以从项目中心创建并登记新项目工作台。
 - `starwork doctor` 第一版已经可以检查工作台健康状态。
+- `starwork upgrade` 第一版已经可以按 skill 生成的 blueprint 保守升级历史模板。
 - `starwork adapt` 第一版已经可以生成或登记 Agent 适配入口。
 - `starwork pack install` 第一版已经可以在健康工作台上补装 Pack。
-- `starwork spawn --blueprint` 第一版已经可以按工作台定制单生成定制化卫星项目；`starworkSpawn` skill 第一版用于生成工作台定制单。
-
-所以，下一步不应该继续扩张 Core 或 CLI，而应该进入第一个场景 Pack 与 Demo 验证。
+- `starwork spawn --blueprint` 第一版已经可以按工作台定制单创建定制化项目工作台；`starworkSpawn` skill 第一版用于生成工作台定制单。
+- `starwork --version` 与产品化 help 文案已补齐，方便 A 测用户确认安装版本和入口命令。
+- `starwork audit` / `starwork repair` 第一版已经可以让项目中心巡检并保守修复已登记项目。
+- `starwork multiagent` 已从早期 Codex 单宿主编排升级为 v0.4 runtime host routing：能识别宿主能力、返回 `manual_handoff_required` / `unbound` / `needs_adapt` 等状态，并在无法自动投递时输出可复制交接消息。
+- MultiAgent v0.7 已通过复验：Codex 主流程由 `starworkMultiagent` 直接使用标准会话工具创建、投递、读取、改名、置顶和归档，CLI 只生成消息模板、标题建议、状态记录和降级提示。
+- Host Adapter v0.2 已补齐 Cursor transcript 只读摘要、Cursor agent status 安全探测和 Trae 人工宿主收敛。
+- Project Structure v0.2 已补齐新手初始化语言：`starwork init` 和 Init-family Skills 先讲产品、流程和安全边界，dry-run 按用户视角展示“会创建 / 会更新 / 不会改动 / 需要确认”。
+- M2.8 已统一工作台命名体系，对外使用“项目工作台 / 项目中心 / 中心管理的项目工作台”。
+- M2.10 已完成 Core Kit / Pack 边界清理：Project Kit 不再固定通用工作目录，General Pack 负责参考资料、草稿和确认成果目录。
+- M2.11 知识库能力已进入当前公开口径：Project Kit 不再默认包含 `知识/knowledge`，项目知识库通过 `starwork knowledge` 和 `starworkKnowledge` 按需开启。
+
+所以，下一步不应该立刻进入新场景 Pack。当前应进入 M2.12 发布与 A 测稳定化，先把 `0.1.0-alpha.20` 的 README、docs、CLI、Skills、本机安装和 npm latest 口径彻底对齐，再用 Golden Demo Workspaces 验证 StarWork 是否能被新人稳定理解。
 
 ## 总路线
 
@@ -32,6 +42,18 @@ M1 Core v0.1 封版
   ↓
 M2 CLI v0.1 最小闭环
   ↓
+M2.5 公开 A 测分发与安装验证
+  ↓
+M2.6 既有功能优化与 A 测稳定化
+  ↓
+M2.8/M2.10 命名体系与 Kit/Pack 边界清理
+  ↓
+M2.11 知识库能力
+  ↓
+M2.12 发布与 A 测稳定化
+  ↓
+M2.13 Golden Demo Workspaces
+  ↓
 M3 Content Creator Pack v0.1
   ↓
 M4 Demo 工作区
@@ -53,17 +75,17 @@ M8 v1.0 稳定产品
 
 已完成：
 
-- 建立 `product/` 与 `matters/` 双工作区。
+- 建立 `product/` 产品事实源；历史推进材料后续归档到 `product/planning/`。
 - 将 `product/` 初始化为独立 Git 仓库。
 - 明确 StarWork 四层：Core、CLI、Packs、Course。
 - 明确 Course 继续由 `珍妮丁丁GFM` 承载，本项目只承载产品本体。
-- 明确旧 `/Users/shuxinding/Project/StarWork` 只作为历史参考。
+- 明确旧本地 Runtime spike 只作为历史参考。
 
 验收标准：
 
 - 产品事实源只认 `product/`。
-- 推进过程只进 `matters/`。
-- 当前项目状态、当前工作和事项注册表可读。
+- 功能规划、版本 SPEC、讨论和验收材料进入 `product/planning/`。
+- 当前项目状态、当前工作和产品规划入口可读。
 
 ## M1 Core v0.1 封版
 
@@ -83,7 +105,7 @@ M8 v1.0 稳定产品
 
 封版结论：
 
-- Core v0.1 的最小协议、五类 Kit 结构和 Kit 事实依据可以作为后续 CLI 检查、适配和 Pack 安装的基础。
+- Core v0.1 的最小协议、Project Kit / 项目中心 Kit 和 Kit 事实依据可以作为后续 CLI 检查、适配和 Pack 安装的基础。
 - 后续不再继续扩张 Core v0.1 的范围；发现问题时优先通过 `doctor` 检查、Pack 规则或 v0.2 候选项处理。
 
 验收标准：
@@ -102,7 +124,7 @@ M8 v1.0 稳定产品
 
 - `starwork init` 第一版已落地。
 - `init` 已支持工作区类型选择、Pack 选择、语言配置、dry-run 和冲突保护。
-- `starwork spawn` 第一版已落地，可从健康 Hub 创建 `satellite-starter` / `satellite-matter` 项目工作台，并回写 Hub 项目注册表。
+- `starwork spawn` 第一版已落地，可从健康项目中心创建项目工作台，并回写项目中心项目注册表。旧 `starter` 参数只作为兼容别名。
 - `starwork doctor` 第一版已落地，可检查 workspace state、Core 必需角色、Kit 文件、正式事实源、业务工作区和 Pack 落地结果。
 - `starwork adapt` 第一版已落地，可为 Codex、Claude Code、Cursor、Trae 生成或登记轻量适配入口。
 - `starwork pack install` 第一版已落地，可在健康工作台上补装 Pack。
@@ -121,9 +143,147 @@ M8 v1.0 稳定产品
 - 用户可以为当前 Agent 生成或更新适配文件。
 - 用户可以安装或更新 Pack，并且不会覆盖已有内容。
 
+## M2.5 公开 A 测分发与安装验证
+
+状态：已形成可公开测试的基线，继续收集反馈。
+
+目标：让外部 A 测用户可以通过公开 GitHub 与 npm 入口安装 StarWork，并验证 CLI 与 Skills 的最小流程。
+
+当前成果：
+
+- GitHub 仓库已推送到 `jennie-shawn/StarWork`。
+- npm 包名为 `@jennie-shawn/starwork`。
+- `starworkInit`、`starworkDoctor`、`starworkMultiagent` 可通过一条 `npx skills add` 命令安装为系统 Skill；`starworkDoctor` 同时承担历史模板诊断、类似项目中心的旧工作区诊断和升级蓝图生成；`starworkSpawn`、`starworkAudit` 改为项目中心自带 Skill。
+- 公开 README 已改为中文首页。
+- 已新增面向 Agent 的安装指南：`product/docs/agent-install-guide.md`。
+- npm `latest` 已发布到 `@jennie-shawn/starwork@0.1.0-alpha.20`，本机 CLI 与系统 Skills 已完成更新验证。
+- `starwork --version` 已可直接输出包版本，`starwork --help` 已改为面向 A 测用户的命令入口说明。
+- `starwork upgrade --blueprint`、`starworkDoctor`、类似项目中心的旧工作区 preserve-names 接入和 Skill 分发第一版已进入公开包。
+- `starwork audit` / `starwork repair` 已进入公开包，项目中心可巡检并按 blueprint 保守修复它管理的项目工作台。
+- `starwork multiagent` v0.4 已进入公开口径：通过 runtime host routing 解释宿主能力，不再用低层 thread/resume + turn/start 模拟跨会话投递；无法自动送达时返回 `manual_handoff_required` 并输出可复制交接消息。
+- Host Adapter v0.2 已进入公开口径：Cursor 支持 transcript 只读摘要和 `cursor agent status` 安全探测；Trae 收敛为人工宿主，不读取私有会话存储。
+
+验收标准：
+
+- A 测用户能安装 CLI 并看到 `starwork --help`。
+- A 测用户能安装系统 Skills，并让 Agent 识别 `starworkInit`、`starworkDoctor`、`starworkMultiagent`。
+- 项目中心能带出工作台模板自带的 `starworkSpawn`、`starworkAudit`，单项目工作台能带出模板自带的 `neat-freak`。
+- `init -> doctor -> hub init -> spawn -> doctor` 的最小流程能被外部用户跑通。
+- 历史模板用户能跑通 `doctor --json -> starworkDoctor -> upgrade --blueprint -> doctor` 的保守升级验证流程。
+- 类似项目中心的旧工作区用户能在确认路径映射后，以保留原目录名的方式接入 StarWork，不创建重复的标准目录壳。
+- A 测反馈中暴露的安装、skill 调用和真实用户体验问题被记录到 `product/planning/issues/`。
+
+## M2.6 既有功能优化与 A 测稳定化
+
+状态：已推进完成一轮关键边界清理，继续作为 A 测稳定化背景线。
+
+目标：不急着扩张新能力，先把已经有的 CLI、Skills、Kit 和文档链路打磨到外部用户和 Agent 都不容易走偏。
+
+优化主线：
+
+- 安装链路：README、A 测指南、Agent 安装指南、系统级 Skills 安装命令保持一致。
+- 新建工作台链路：继续打磨 `starworkInit` 与 `starwork init` 的语言选择、项目工作台 / 项目中心判断、Pack 默认值和定制采访。
+- 历史模板升级链路：继续打磨 `doctor --json -> starworkDoctor -> upgrade --blueprint -> doctor`，重点保证规则文档质量和用户原有规则提炼。
+- 项目中心链路：继续打磨 `hub -> spawn -> audit -> repair`，确保项目中心自带 Skill、项目中心 Skill registry 和中心管理项目的结构边界清楚。
+- Skill 范围治理：维护系统级 Skill、工作台模板自带 Skill、项目中心托管 Skill、Pack Skill 和项目本地 Skill 的分发边界。
+- 多 Agent 协作：继续优化 `multiagent status`、`bind`、`launch`、`read`、`instruct`、`share` 的人类可读输出和 worklog 提醒。
+
+验收标准：
+
+- 文档中的当前版本、当前阶段和下一步不互相矛盾。
+- A 测用户能按公开 README 和 A 测指南完成 CLI 与系统 Skills 安装。
+- Agent 读取 `starworkInit`、`starworkDoctor`、`starworkMultiagent` 时不会被旧 Pack、旧事项模式或旧 skill 分发口径误导。
+- 历史模板升级生成的 `AGENTS.md` 简洁、清晰，没有内部占位符泄露。
+- 项目中心 / 项目工作台模板自带 Skill 不会被系统级安装命令误装。
+
+## M2.8/M2.10 命名体系与 Kit/Pack 边界清理
+
+状态：已完成。
+
+目标：清理外部用户和 Agent 最容易走偏的命名和结构边界。
+
+当前成果：
+
+- 对外统一使用“项目工作台 / 项目中心 / 中心管理的项目工作台”，不再要求用户理解 Satellite。
+- Project Kit 只保留基础工作台骨架，不再固定 `参考资料/` 和 `输出/`。
+- General Pack 接管通用工作目录：`参考资料/`、`输出/草稿/`、`输出/确认成果/`，英文镜像为 `references/`、`outputs/drafts/`、`outputs/final/`。
+- 中文项目中心使用中文可见目录；英文 Project Center 使用英文可见目录；隐藏机制目录保持英文。
+- `doctor` 已能识别项目中心同义目录重复，例如 `知识/` 和 `knowledge/` 同时存在。
+- M2.10 验收补丁已清理 Core profile 中的 `work.starter.*` 当前角色残留。
+
+验收标准：
+
+- 只看 Project Kit 时，不会看到通用 Pack 目录。
+- 普通 `init --type project --pack general` 仍能生成用户熟悉的参考资料和输出目录。
+- 中文 / 英文项目中心的可见目录语言一致。
+- Core profile 不再把 General Pack 目录写成基础事实源。
+
+## M2.11 知识库能力
+
+状态：已完成本地验收，并进入当前 A 测口径。
+
+目标：把 `知识/knowledge` 从“默认目录”进一步定义为可选知识库能力，避免它在项目资料、长期理解和项目中心共享知识之间语义混乱。
+
+当前判断：
+
+- 参考资料是输入。
+- 输出是成果。
+- 知识库是 Agent 持续维护的长期理解层。
+- 项目知识库和项目中心共享知识不是同一个东西。
+
+当前成果：
+
+- Project Kit 已移除默认 `知识/knowledge`。
+- 新增 `core/capabilities/knowledge/`，提供中文 `知识库/` 和英文 `knowledge-base/` 模板。
+- 新增 `starwork knowledge init/status/check/apply`，并支持 `init --knowledge`。
+- `doctor` 不把缺少知识库当作结构错误；旧 `知识/knowledge` 只作为线索暴露。
+- 新增系统级 skill `starworkKnowledge`，负责引导创建、吸收资料、回答并沉淀、形成综合判断、健康检查和生成整理 blueprint。
+
+下一步：
+
+- 用真实 A 测样本验证 `starworkKnowledge` 是否能避免把原始资料、草稿和知识库混在一起。
+- 继续观察项目中心共享知识库是否需要另开需求。
+
+## M2.12 发布与 A 测稳定化
+
+状态：当前阶段。
+
+目标：把已经进入公开包的 CLI、Skills、文档和发布材料统一成可信的 A 测入口，减少“代码可用但用户被旧文档带偏”的风险。
+
+当前重点：
+
+- 对齐 README、A 测指南、Agent 安装指南、CLI/Skill 注册说明和 roadmap 的版本号、命令和能力边界。
+- 为 `manual_handoff_required`、Cursor transcript 只读摘要、Trae 人工宿主等 host adapter 行为补齐用户可理解说明。
+- 建立每次 npm 发布后的 release checklist：版本检查、latest 检查、本机 CLI/Skill 更新、关键命令 smoke test、文档漂移检查。
+- 继续复验 `init -> doctor -> hub init -> spawn -> audit -> repair`、`knowledge`、`multiagent`、`adapt` 这些 A 测高频链路。
+
+验收标准：
+
+- `product/README.md`、`product/docs/`、`product/cli/README.md` 和 A 测指南中的 latest 版本与实际 npm latest 一致。
+- 新用户只按公开文档操作时，不会遇到已经废弃的 alpha 版本、旧 MultiAgent 状态名或旧宿主能力说法。
+- 每个无法自动化的跨会话动作，都有可复制消息和明确的人工交付说明。
+
+## M2.13 Golden Demo Workspaces
+
+状态：建议紧随 M2.12 启动。
+
+目标：用少量高质量示例证明 StarWork 的价值，不再只靠命令和 SPEC 解释产品。
+
+建议最小样本：
+
+- 一个项目工作台：展示 `init`、`doctor`、`knowledge`、`general pack` 和基础规则入口。
+- 一个项目中心：展示 `hub init`、`spawn`、`audit`、`repair` 和中心管理项目登记。
+- 一个 MultiAgent 协作样本：展示 product-planning、development、operations 等 lane 的职责边界、worklog、shared 消息和人工交接。
+
+验收标准：
+
+- 新人能在 10 分钟内看懂 StarWork 到底解决什么问题。
+- Demo 能暴露真实工作流，而不是只展示目录树。
+- Demo 中的 CLI 输出、Skill 行为和文档说明一致。
+
 ## M3 Content Creator Pack v0.1
 
-状态：下一阶段。
+状态：后续阶段，等待 M2.12/M2.13 稳定后再启动，并结合 GFM 新一期课程内容整理。
 
 目标：做出第一个真正能解决场景问题的 Pack，而不是只有目录结构。
 
@@ -147,7 +307,7 @@ Pack 应覆盖的最小内容闭环：
 
 还需要做：
 
-- 创建自媒体内容创作者 Pack v0.1 matter。
+- 创建内容创作者 Pack v0.1 功能档案。
 - 确认目录结构。
 - 确认每个目录下的 Agent 规则。
 - 确认模板和 seed 示例。
@@ -213,7 +373,7 @@ Pack 应覆盖的最小内容闭环：
 - Core v0.1 协议。
 - CLI v0.1。
 - General Pack。
-- Hub Management Pack。
+- 项目中心管理 Pack。
 - Content Creator Pack v0.1。
 - Demo 工作区。
 - 入门文档。
@@ -237,7 +397,7 @@ Pack 应覆盖的最小内容闭环：
 - `doctor` 自动修复建议。
 - Pack 升级、卸载和迁移机制。
 - 更多 Packs。
-- 更强的主库与卫星项目同步能力。
+- 更强的项目中心与项目工作台同步能力。
 - schema 校验和版本迁移。
 
 进入条件：
@@ -262,11 +422,16 @@ v1.0 应具备：
 
 ## 当前下一步
 
-当前最应该做的不是重开 Core 或继续扩张 CLI，而是进入 M3：
+当前最应该做的不是重开 Core、继续无边界扩张 CLI，或立刻进入新 Pack，而是完成 M2.12 发布与 A 测稳定化：
 
-1. 新建 Content Creator Pack v0.1 matter：把首个场景 Pack 的目录、规则、模板和 Demo 定下来。
-2. 用已完成的 CLI 最小闭环生成 Demo 工作区，验证 `init -> doctor -> adapt -> pack install` 是否真的顺。
+1. 用公开安装命令验证 `@jennie-shawn/starwork@latest`、系统级 Skills 和本机更新链路。
+2. 清理 README、docs、CLI README、A 测指南和 Skill 注册说明中的版本漂移。
+3. 用真实项目验证知识库能力是否能清楚区分参考资料、输出和长期知识。
+4. 用真实宿主继续验证 `multiagent read/status/instruct/launch` 的状态输出，尤其是 `manual_handoff_required` 是否足够清楚。
+5. 继续优化安装、`init`、`doctor -> starworkDoctor -> upgrade`、`hub -> spawn -> audit -> repair`、`multiagent`、`knowledge` 和 `adapt` 这些既有链路。
+6. 制作 Golden Demo Workspaces，把产品价值从“命令能跑”推进到“新人能看懂”。
+7. 等 M2.12/M2.13 稳定后，再启动 Content Creator Pack v0.1 功能档案，把首个场景 Pack 的目录、规则、模板和 Demo 定下来。
 
-如果只能选一个，先做 Content Creator Pack v0.1 matter。
+如果只能选一个，先修复版本、发布和文档漂移，因为这直接决定 A 测用户能不能按公开入口跑通。
 
-原因：M2 已经提供了最小 CLI 工具链，下一步需要用真实场景检验产品价值。
+原因：M2 已经提供了最小 CLI 工具链，A 测版本也已发布；现在最容易产生体验落差的是 CLI 与 Skill 之间的协同、提示、容错、宿主能力边界和文档状态漂移。

package/docs/v0.1-plan.md

@@ -8,24 +8,24 @@ StarWork v0.1 采用三条线并行推进。
 
 目标：冻结跨 Agent 工作区的最小协议。
 
-当前状态：已封版。已形成中文第一阅读入口 `product/core/core-v0.1-protocol.md`，并已落地 `baseline + profiles + capabilities + presets + kits` 的维护结构。Kit 结构已收敛为五类，事实依据见 `product/core/kits/kit-structure-reference.md`。
+当前状态：已封版，并在 M2.10 完成 Kit / Pack 边界清理。已形成中文第一阅读入口 `product/core/core-v0.1-protocol.md`，并已落地 `baseline + profiles + capabilities + presets + kits` 的维护结构。正式 Kit 收敛为 Project Kit 与项目中心 Kit；通用工作目录由 General Pack 提供，事实依据见 `product/core/kits/kit-structure-reference.md`。
 
 关键问题：
 
 - Agent 每次开始工作前读什么？
 - 用户身份、项目状态、决策、教训和当前工作分别放在哪里？
-- 一个 matter 如何创建、推进和归档？
+- 一个功能或问题如何创建、推进和归档？
 - 哪些文件默认只读？
 - 哪些动作需要用户确认？
 - 多个 Agent 如何共享同一工作区上下文？
 
-Core 必须保持跨行业、跨场景、跨 Agent，不混入自媒体内容创作者 Pack 的专属逻辑。
+Core 必须保持跨行业、跨场景、跨 Agent，不混入内容创作者 Pack 的专属逻辑。
 
 ### CLI v0.1
 
 目标：提供最小可用的安装和适配工具。
 
-当前状态：CLI v0.1 最小闭环已完成。`starwork init`、`starwork spawn`、`starwork doctor`、`starwork adapt` 和 `starwork pack install` 第一版均已落地。
+当前状态：CLI v0.1 最小闭环已完成。`starwork init`、`starwork spawn`、`starwork doctor`、`starwork knowledge`、`starwork upgrade`、`starwork adapt`、`starwork pack install` 和 `starwork multiagent` 第一版均已落地。
 
 首版命令边界：
 
@@ -33,12 +33,25 @@ Core 必须保持跨行业、跨场景、跨 Agent，不混入自媒体内容创
 starwork init
 starwork spawn
 starwork doctor
+starwork knowledge
+starwork upgrade
 starwork adapt
-starwork pack install content-creator
+starwork pack install
+starwork multiagent
 ```
 
 CLI 在安装、生成或更新时必须保护用户已有内容。它可以生成或更新 Agent 适配文件，也可以从 Hub 生成新项目工作台，但不能覆盖项目事实源。
 
+公开 A 测状态：
+
+- GitHub 仓库为 `jennie-shawn/StarWork`。
+- npm 包为 `@jennie-shawn/starwork`。
+- `starworkInit`、`starworkDoctor`、`starworkMultiagent`、`starworkKnowledge` 已可通过一条 `npx skills add jennie-shawn/StarWork` 命令安装为系统 Skill；`starworkDoctor` 同时承担历史模板诊断、类似项目中心旧工作区诊断和升级蓝图生成；`starworkSpawn`、`starworkAudit` 改为项目中心 Kit 自带 Skill。
+- npm `latest` 已验证到 `@jennie-shawn/starwork@0.1.0-alpha.20`；Host Adapter v0.2 与 MultiAgent v0.5 / ISSUE-014 修复已通过产品复验并进入发布口径。
+- 当前推进阶段为 MultiAgent / Host Adapter 迭代后的 M2.12 发布与 A 测稳定化；M2.8 命名体系优化、M2.10 Core Kit / Pack 边界清理、M2.11 知识库能力、MultiAgent v0.4 runtime host routing 和 Host Adapter v0.2 均已进入当前产品口径。
+- Kit 自带 Skill 和 Hub Skill registry 第一版已进入 CLI：`init` 写入 `.starwork/skills.json`，Hub Kit 自带 `starworkSpawn`，单项目 Kit 自带 `neat-freak`，`doctor` 会暴露 Skill 安装事实。
+- `starwork multiagent` 已支持 Agent Lanes、宿主观察、launch 和跨会话指令。当前边界是：CLI 运行时判断宿主标准投递能力，不可自动送达时返回 `manual_handoff_required` 并在非 JSON 输出中直接打印可复制 handoff message；Cursor 只读 transcript，Trae 走人工操作。
+
 M2 完成后新增的定制生成方向：
 
 - `starwork spawn --blueprint` 第一版已落地，用于让 CLI 按工作台定制单生成定制化卫星项目。
@@ -53,9 +66,16 @@ Pack 选择 -> Pack 语言配置
 Kit 文件 + Pack 规则 / seed / templates -> 最终工作台
 ```
 
-### 自媒体内容创作者 Pack v0.1
+M2.10 后的结构边界：
+
+- Project Kit 只定义基础工作台骨架。
+- General Pack 负责 `参考资料/`、`输出/草稿/`、`输出/确认成果/` 及英文镜像。
+- 项目知识库不是基础骨架；需要时通过 `starwork knowledge init` 开启 `知识库/` 或 `knowledge-base/`。
+- 项目中心可见目录按语言生成，隐藏机制目录保持英文。
+
+### 内容创作者 Pack v0.1
 
-目标：提供首个面向自媒体内容创作者的完整场景工作流包。
+目标：提供首个面向内容创作者的完整场景工作流包。
 
 Pack 应覆盖：
 
@@ -64,7 +84,7 @@ Pack 应覆盖：
 - 素材库
 - 爆款拆解
 - 内容日历
-- 单篇内容事项
+- 单篇内容工作流
 - 草稿与脚本
 - 发布记录
 - 数据复盘
@@ -97,13 +117,13 @@ seed/<language>/
 - 用户不需要理解 Core 内部机制也能开始工作。
 - 项目能产出一个完整 Demo 案例。
 
-## 首轮事项
+## 首轮工作
 
-首轮应建立以下事项：
+首轮应建立以下工作：
 
 1. Core v0.1 协议草案：已封版
 2. CLI v0.1 命令边界：已完成最小闭环，`init`、`spawn`、`doctor`、`adapt`、`pack install` 第一版已落地
-3. 自媒体内容创作者 Pack v0.1 MVP 范围
+3. 内容创作者 Pack v0.1 MVP 范围
 4. 旧 Runtime spike 复核
 
-这些事项中的成熟草案再晋升到 `product/`。
+这些工作中的成熟草案再晋升到 `product/`。

package/kit-skills/README.md

@@ -0,0 +1,11 @@
+# StarWork Kit Skills
+
+这里存放 StarWork Kit 自带 skill。
+
+这些 skill 不应该通过 `npx skills add jennie-shawn/StarWork` 安装到全局 Agent 环境，而是由 `starwork init` 按工作区类型写入具体工作台。
+
+## 当前工作台自带 Skills
+
+- `starworkSpawn/`：项目中心工作台自带，帮助已有项目中心设计 `starwork spawn --blueprint` 工作台定制单。
+- `starworkAudit/`：项目中心工作台自带，帮助项目中心巡检它管理的项目工作台，并生成 `starwork repair --blueprint` 修复蓝图。
+- `neat-freak/`：项目工作台自带，帮助项目工作台进行阶段性收尾、整理和归档。

package/kit-skills/neat-freak/SKILL.md

@@ -0,0 +1,32 @@
+# neat-freak
+
+Use this skill when a StarWork single-project workspace needs end-of-session cleanup, project memory reconciliation, or a careful pass over docs before pausing work.
+
+## Purpose
+
+This bundled StarWork edition is intentionally small. It helps an agent close a work session without losing important context.
+
+## Workflow
+
+1. Read the project entry rules, usually `AGENTS.md`.
+2. Read the current work file from `.starwork/workspace.json` and the Kit defaults.
+3. Check whether product facts, process notes, and current task records are stored in the correct places.
+4. Summarize what changed in this session.
+5. Update the current work record if the workspace rules allow it.
+6. List any unresolved risks, follow-ups, or decisions that need the user's attention.
+
+## Rules
+
+- Do not delete or rewrite user content during cleanup.
+- Do not move files unless the user explicitly asks.
+- Keep product facts separate from process notes.
+- If the workspace has project-specific process folders, keep their progress and registry status consistent.
+- If unsure where something belongs, explain the ambiguity instead of guessing.
+
+## Output
+
+Return a concise cleanup report:
+
+- What was reconciled.
+- What still needs attention.
+- Which files were updated, if any.

package/kit-skills/neat-freak/agents/openai.yaml

@@ -0,0 +1,2 @@
+name: neat-freak
+description: End-of-session cleanup and project memory reconciliation for StarWork single-project workspaces.