npm - @jennie-shawn/starwork - Versions diffs - 0.1.0-alpha.2 → 0.1.0-alpha.21 - Mend

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

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 (298) hide show

package/docs/cli-skill-registry.html ADDED Viewed

@@ -0,0 +1,801 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>StarWork CLI 与 Skill 能力注册表</title>
+  <style>
+    :root {
+      --paper: #f7f4ec;
+      --paper-2: #ebe5d7;
+      --ink: #1d211d;
+      --muted: #62675f;
+      --line: #cfc7b7;
+      --white: #fffdf7;
+      --green: #286d4a;
+      --green-soft: #d8eadc;
+      --amber: #b36b19;
+      --amber-soft: #f3dfbd;
+      --blue: #2f6286;
+      --blue-soft: #d7e4ea;
+      --red: #9b3d2c;
+      --red-soft: #edd6cf;
+      --shadow: 0 18px 50px rgba(47, 43, 34, 0.12);
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      color: var(--ink);
+      background:
+        linear-gradient(90deg, rgba(62, 71, 62, 0.052) 1px, transparent 1px),
+        linear-gradient(0deg, rgba(62, 71, 62, 0.045) 1px, transparent 1px),
+        var(--paper);
+      background-size: 34px 34px;
+      font-family: "Avenir Next", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+      letter-spacing: 0;
+    }
+    .page {
+      width: min(1180px, calc(100% - 40px));
+      margin: 0 auto;
+      padding: 42px 0 72px;
+    }
+    .home-link {
+      display: inline-flex;
+      align-items: center;
+      min-height: 34px;
+      margin-bottom: 18px;
+      padding: 6px 11px;
+      border: 1px solid var(--line);
+      border-radius: 999px;
+      background: rgba(255, 253, 247, 0.75);
+      color: var(--muted);
+      font-size: 14px;
+      font-weight: 800;
+      text-decoration: none;
+    }
+    .hero {
+      display: grid;
+      grid-template-columns: minmax(0, 1.05fr) minmax(340px, 0.75fr);
+      gap: 28px;
+      align-items: stretch;
+      min-height: 430px;
+    }
+    .hero-copy {
+      display: flex;
+      flex-direction: column;
+      justify-content: space-between;
+      padding: 34px 0 30px;
+      border-top: 2px solid var(--ink);
+      border-bottom: 2px solid var(--ink);
+    }
+    .kicker {
+      margin: 0 0 20px;
+      color: var(--green);
+      font-size: 13px;
+      font-weight: 900;
+      text-transform: uppercase;
+    }
+    h1, h2, h3 {
+      font-family: Georgia, "Times New Roman", "Songti SC", serif;
+      letter-spacing: 0;
+    }
+    h1 {
+      margin: 0;
+      max-width: 820px;
+      font-size: clamp(44px, 7vw, 82px);
+      line-height: 0.98;
+    }
+    h2 {
+      margin: 0;
+      font-size: clamp(30px, 4.4vw, 52px);
+      line-height: 1.03;
+    }
+    h3 {
+      margin: 0 0 10px;
+      font-size: 24px;
+      line-height: 1.16;
+    }
+    p {
+      margin: 0;
+      color: var(--muted);
+      line-height: 1.72;
+    }
+    code {
+      padding: 2px 6px;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: rgba(29, 33, 29, 0.05);
+      font-family: "SFMono-Regular", "Menlo", "Consolas", monospace;
+      font-size: 0.92em;
+    }
+    pre {
+      margin: 0;
+      padding: 16px;
+      overflow: auto;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: #1f231f;
+      color: #f7f4ec;
+      font-family: "SFMono-Regular", "Menlo", "Consolas", monospace;
+      font-size: 13px;
+      line-height: 1.65;
+      white-space: pre-wrap;
+    }
+    .subtitle {
+      max-width: 760px;
+      margin: 28px 0 0;
+      color: var(--muted);
+      font-size: 19px;
+      line-height: 1.78;
+    }
+    .hero-board {
+      padding: 20px;
+      display: flex;
+      align-items: center;
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      background: var(--white);
+      box-shadow: var(--shadow);
+    }
+    svg {
+      display: block;
+      width: 100%;
+      height: auto;
+    }
+    .quick-row {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 10px;
+      margin-top: 34px;
+    }
+    .quick {
+      min-height: 112px;
+      padding: 14px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.82);
+    }
+    .quick b {
+      display: block;
+      margin-bottom: 8px;
+      color: var(--green);
+      font-size: 13px;
+    }
+    .quick span {
+      color: var(--muted);
+      font-size: 15px;
+      line-height: 1.66;
+    }
+    .section {
+      margin-top: 70px;
+    }
+    .section-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: end;
+      gap: 24px;
+      margin-bottom: 24px;
+      padding-bottom: 14px;
+      border-bottom: 2px solid var(--ink);
+    }
+    .section-note {
+      max-width: 520px;
+      font-size: 15px;
+    }
+    .grid-2 {
+      display: grid;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+      gap: 16px;
+    }
+    .grid-3 {
+      display: grid;
+      grid-template-columns: repeat(3, minmax(0, 1fr));
+      gap: 16px;
+    }
+    .panel {
+      padding: 20px;
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.82);
+    }
+    .panel.soft {
+      border-color: var(--line);
+    }
+    .badge {
+      display: inline-flex;
+      align-items: center;
+      min-height: 28px;
+      margin-bottom: 14px;
+      padding: 4px 10px;
+      border: 1px solid var(--line);
+      border-radius: 999px;
+      background: var(--paper);
+      color: var(--green);
+      font-size: 12px;
+      font-weight: 900;
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      border: 2px solid var(--ink);
+      background: rgba(255, 253, 247, 0.82);
+    }
+    th, td {
+      padding: 15px 14px;
+      border: 1px solid var(--line);
+      text-align: left;
+      vertical-align: top;
+      font-size: 15px;
+      line-height: 1.65;
+    }
+    th {
+      color: var(--green);
+      background: var(--paper-2);
+      font-size: 13px;
+      font-weight: 900;
+      text-transform: uppercase;
+    }
+    td {
+      color: var(--muted);
+    }
+    td strong {
+      color: var(--ink);
+    }
+    .status {
+      display: inline-flex;
+      align-items: center;
+      min-height: 26px;
+      padding: 3px 9px;
+      border-radius: 999px;
+      font-size: 12px;
+      font-weight: 900;
+      white-space: nowrap;
+    }
+    .done {
+      border: 1px solid #91b89b;
+      background: var(--green-soft);
+      color: var(--green);
+    }
+    .planned {
+      border: 1px solid #d2aa67;
+      background: var(--amber-soft);
+      color: var(--amber);
+    }
+    .callout {
+      margin-top: 18px;
+      padding: 18px;
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      background: var(--white);
+      font-size: 16px;
+      line-height: 1.75;
+    }
+    .flow {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 10px;
+    }
+    .flow-step {
+      min-height: 150px;
+      padding: 18px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.82);
+    }
+    .flow-step strong {
+      display: inline-flex;
+      min-height: 28px;
+      margin-bottom: 12px;
+      padding: 4px 10px;
+      border-radius: 999px;
+      background: var(--green-soft);
+      color: var(--green);
+      font-size: 12px;
+    }
+    .flow-step span {
+      display: block;
+      margin-bottom: 8px;
+      color: var(--ink);
+      font-weight: 900;
+    }
+    .flow-step p {
+      font-size: 14px;
+    }
+    @media (max-width: 960px) {
+      .hero, .grid-2, .grid-3, .flow {
+        grid-template-columns: 1fr;
+      }
+      .quick-row {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+      }
+      .section-header {
+        display: block;
+      }
+      .section-note {
+        margin-top: 12px;
+      }
+    }
+    @media (max-width: 640px) {
+      .page {
+        width: min(100% - 24px, 1180px);
+      }
+      .quick-row {
+        grid-template-columns: 1fr;
+      }
+      table, thead, tbody, tr, th, td {
+        display: block;
+      }
+      th {
+        display: none;
+      }
+      td {
+        border-left: 0;
+        border-right: 0;
+      }
+      tr {
+        border-bottom: 2px solid var(--ink);
+      }
+    }
+  </style>
+</head>
+<body>
+  <main class="page">
+    <a class="home-link" href="index.html">返回文档中心</a>
+    <section class="hero">
+      <div class="hero-copy">
+        <div>
+          <p class="kicker">CLI + Skills Registry</p>
+          <h1>能力注册表</h1>
+          <p class="subtitle">这页是 StarWork 当前 CLI 与自研 Skills 的总览。后续新增命令、改名、能力边界变化，都要同步更新这里。</p>
+        </div>
+        <div class="quick-row">
+          <div class="quick"><b>CLI</b><span>负责稳定执行：创建、检查、适配、安装、升级。</span></div>
+          <div class="quick"><b>Skills</b><span>负责 AI 判断：采访、诊断、生成可执行方案。</span></div>
+          <div class="quick"><b>Blueprint</b><span>让 AI 的判断变成 CLI 可校验、可 dry-run 的施工图。</span></div>
+          <div class="quick"><b>维护日期</b><span>最后更新：2026-05-22。</span></div>
+        </div>
+      </div>
+      <div class="hero-board">
+        <svg viewBox="0 0 720 520" role="img" aria-labelledby="map-title map-desc">
+          <title id="map-title">StarWork CLI 和 Skill 分工</title>
+          <desc id="map-desc">Skills 位于判断层，生成方案；CLI 位于执行层，按参数和方案稳定执行。</desc>
+          <defs>
+            <marker id="arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+              <path d="M0 0 L10 5 L0 10 z" fill="#3e473e"></path>
+            </marker>
+          </defs>
+          <rect x="24" y="24" width="672" height="472" rx="10" fill="#f7f4ec" stroke="#1d211d" stroke-width="3"></rect>
+          <text x="54" y="72" font-size="28" font-weight="900" fill="#1d211d">判断层 -> 执行层</text>
+          <text x="54" y="104" font-size="14" fill="#62675f">AI 负责理解现实，CLI 负责稳定施工。</text>
+          <rect x="66" y="146" width="240" height="252" rx="8" fill="#d7e4ea" stroke="#2f6286" stroke-width="2"></rect>
+          <text x="186" y="180" text-anchor="middle" font-size="18" font-weight="900" fill="#2f6286">Skills</text>
+          <rect x="94" y="210" width="184" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="186" y="231" text-anchor="middle" font-size="13" fill="#1d211d">starworkInit</text>
+          <rect x="94" y="250" width="184" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="186" y="271" text-anchor="middle" font-size="13" fill="#1d211d">starworkSpawn</text>
+          <rect x="94" y="290" width="184" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="186" y="311" text-anchor="middle" font-size="13" fill="#1d211d">starworkDoctor</text>
+          <rect x="94" y="330" width="184" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="186" y="351" text-anchor="middle" font-size="13" fill="#1d211d">starworkMultiagent</text>
+          <rect x="94" y="370" width="184" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="186" y="391" text-anchor="middle" font-size="13" fill="#1d211d">neat-freak</text>
+          <line x1="306" y1="272" x2="410" y2="272" stroke="#3e473e" stroke-width="3" marker-end="url(#arrow)"></line>
+          <text x="358" y="255" text-anchor="middle" font-size="12" fill="#62675f">plan / diagnosis</text>
+          <rect x="410" y="146" width="244" height="252" rx="8" fill="#d8eadc" stroke="#286d4a" stroke-width="2"></rect>
+          <text x="532" y="180" text-anchor="middle" font-size="18" font-weight="900" fill="#286d4a">CLI</text>
+          <rect x="438" y="210" width="188" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="532" y="231" text-anchor="middle" font-size="13" fill="#1d211d">init / spawn</text>
+          <rect x="438" y="250" width="188" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="532" y="271" text-anchor="middle" font-size="13" fill="#1d211d">doctor</text>
+          <rect x="438" y="290" width="188" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="532" y="311" text-anchor="middle" font-size="13" fill="#1d211d">upgrade</text>
+          <rect x="438" y="330" width="188" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="532" y="351" text-anchor="middle" font-size="13" fill="#1d211d">adapt / pack install</text>
+          <rect x="438" y="370" width="188" height="32" rx="7" fill="#fffdf7" stroke="#cfc7b7"></rect>
+          <text x="532" y="391" text-anchor="middle" font-size="13" fill="#1d211d">multiagent</text>
+          <rect x="134" y="428" width="452" height="52" rx="8" fill="#fffdf7" stroke="#1d211d" stroke-width="2"></rect>
+          <text x="360" y="459" text-anchor="middle" font-size="15" font-weight="900" fill="#1d211d">原则：CLI 不硬猜业务语义；Skill 不静默写入。</text>
+        </svg>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>当前总览</h2>
+        <p class="section-note">截至 alpha.20，StarWork 已有 10 个可用 CLI 命令和 9 个 StarWork 自研 Skill，其中 5 个全局系统 Skill、3 个 Kit 自带 Skill、1 个 Capability 项目内 Skill。Skill 已分为 L0 主入口、L1 系统专家、L2 Kit 自带和 L3 Capability 项目内能力；`update` 和 `starwork skill` 仍是未来命令，不在当前可用列表里。新增或调整命令、skill、Kit 分发范围、npm 版本时必须同步维护本页。</p>
+      </div>
+      <div class="grid-3">
+        <article class="panel">
+          <span class="badge">CLI</span>
+          <h3>执行器</h3>
+          <p>命令行负责可重复、可验证、低风险的文件操作。凡是涉及写入，都应支持 dry-run 或明确确认。</p>
+        </article>
+        <article class="panel">
+          <span class="badge">Skills</span>
+          <h3>判断器</h3>
+          <p>Skill 负责把用户的模糊需求变成方案或诊断。它们不直接替代 CLI，也不静默改文件。</p>
+        </article>
+        <article class="panel">
+          <span class="badge">状态</span>
+          <h3>alpha.20</h3>
+          <p>当前 npm latest 为 <code>@jennie-shawn/starwork@0.1.0-alpha.20</code>。已收敛为 Project Kit 与 项目中心 Kit 两类结构，补齐 项目中心 侧 <code>audit</code> / <code>repair</code> 链路，新增 L0 主入口 <code>starwork</code> 并保留 L1 系统专家 Skill，修正系统级 Skill 与 Kit 自带 Skill 的分发边界，新增可选项目知识库命令组 <code>starwork knowledge</code>，完成 MultiAgent v0.7 Codex 标准会话工具主路径，并完成 Host Adapter v0.2：Cursor 仅做 transcript 只读摘要，Trae 仅保留人工操作入口，<code>manual_handoff_required</code> 会直接输出可复制交付消息。</p>
+        </article>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>CLI 注册表</h2>
+        <p class="section-note">这里列出用户能直接运行的命令、主要能力、输入输出和边界。</p>
+      </div>
+      <table>
+        <thead>
+          <tr>
+            <th>命令</th>
+            <th>定位</th>
+            <th>主要能力</th>
+            <th>典型输入</th>
+            <th>产出</th>
+            <th>边界</th>
+            <th>状态</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><strong><code>starwork init</code></strong></td>
+            <td>从空目录创建 StarWork 工作台。</td>
+            <td>初始化项目工作台或 项目中心；创建基础目录、写入工作台身份证、AI 使用说明和入口规则。</td>
+            <td><code>--type</code>、<code>--pack</code>、<code>--language</code>、<code>--target</code>、<code>--dry-run</code>、<code>--yes</code></td>
+            <td>标准工作台目录、<code>.starwork/workspace.json</code>、<code>.starwork/skills.json</code>、<code>AGENTS.md</code> 和必要入口文件。</td>
+            <td>不负责升级已有旧模板；不处理多项目中心管理的项目工作台创建。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork spawn</code></strong></td>
+            <td>从 项目中心 生成 项目工作台 项目。</td>
+            <td>从健康 项目中心创建项目工作台；回写项目注册表；支持按定制方案生成目录、初始文件、规则和 项目中心 托管的 AI 使用说明。</td>
+            <td><code>--hub</code>、<code>--target</code>、<code>--mode</code>、<code>--name</code>、<code>--id</code>、<code>--blueprint</code></td>
+            <td>项目工作台、<code>.core-sync.json</code>、项目中心 项目登记记录、共享资源挂载、项目 AI 使用说明清单。</td>
+            <td>不安装业务场景能力；不写入非空目标目录；只从 项目中心 派生项目。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork doctor</code></strong></td>
+            <td>工作台体检和历史模板探测。</td>
+            <td>检查工作台身份证、入口规则、关键目录、场景能力和 AI 使用说明；对旧目录输出完整目录清单和可整理线索。</td>
+            <td><code>--target</code>、<code>--json</code>、<code>--strict</code>、<code>--verbose</code>、<code>--inventory-depth</code></td>
+            <td>用户可读体检结果或 <code>starwork.doctor.result.v0.1</code> JSON。</td>
+            <td>不输出升级 next steps；不判断目录真实业务语义；不修复文件。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork knowledge</code></strong></td>
+            <td>项目本地知识库能力。</td>
+            <td>创建标准知识库结构；查看知识库状态；检查基础结构；按确认过的 knowledge blueprint 执行安全结构变更。</td>
+            <td><code>init</code>、<code>status</code>、<code>check</code>、<code>apply</code>、<code>--target</code>、<code>--path</code>、<code>--blueprint</code>、<code>--dry-run</code></td>
+            <td><code>知识库/</code> 或 <code>knowledge-base/</code>、能力声明、知识库规则文件；<code>status --json</code> 只输出事实。</td>
+            <td>不总结资料；不判断内容价值；不自动移动、删除或改名旧 <code>知识/</code> / <code>knowledge/</code>。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork upgrade</code></strong></td>
+            <td>按升级蓝图执行历史模板升级。</td>
+            <td>读取 <code>starworkDoctor</code> 生成的升级方案；支持预览、路径安全校验、工作台身份证写入、缺失入口文件补齐、规则注入和旧主库保留原目录名接入。</td>
+            <td><code>--target</code>、<code>--blueprint</code>、<code>--dry-run</code>、<code>--yes</code>、<code>--json</code></td>
+            <td>可被 StarWork 接管的工作台，保留旧目录名和历史文件；类似项目中心的旧主库不创建重复标准目录。</td>
+            <td>不自动生成升级方案；不处理已是 StarWork 的工作台；不移动、不删除、不覆盖历史文件。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork adapt</code></strong></td>
+            <td>生成 AI 工具适配入口。</td>
+            <td>读取宿主能力 profile；<code>--capabilities</code> 只读输出；正式适配会写入宿主规则入口、Skill 目录和 <code>.starwork/adapters.json</code>。</td>
+            <td><code>codex</code>、<code>claude-code</code>、<code>cursor</code>、<code>trae</code>、<code>all</code>、<code>--target</code>、<code>--capabilities</code></td>
+            <td><code>AGENTS.md</code>、<code>CLAUDE.md</code>、Cursor / Trae rules、宿主 Skill 目录和 adapter state。</td>
+            <td>要求工作台检查没有阻塞问题；不改变工作台协议和场景能力；不读写宿主私有数据库或 transcript。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork pack install</code></strong></td>
+            <td>给健康工作台补装场景能力。</td>
+            <td>安装场景目录、初始文件和规则；更新工作台身份证中的场景记录和路径设置。</td>
+            <td><code>pack id</code>、<code>--target</code>、<code>--dry-run</code>、<code>--yes</code></td>
+            <td>场景目录、规则注入、模板缓存、工作台身份证更新。</td>
+            <td>要求目标已是健康 StarWork 工作台；不支持未兼容当前工作台类型的场景能力。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork multiagent</code></strong></td>
+            <td>管理同一项目内多个 AI 会话的职责位协作。</td>
+            <td>初始化 Agent Lanes；新增自定义 lane；维护 lane worklog；绑定或释放 session；记录由 Skill 或人工完成的 request delivery；Cursor / Trae 默认生成 manual handoff。</td>
+            <td><code>init</code>、<code>add</code>、<code>bind</code>、<code>release</code>、<code>status</code>、<code>share</code>、<code>request record</code>，以及非 Codex 宿主的人工交接辅助。</td>
+            <td><code>_系统/协作/agent-lanes.md</code>、<code>_系统/协作/shared.md</code>、<code>.starwork/agent-lanes/state.json</code> 和 lane <code>worklog.md</code>。</td>
+            <td>不内置固定职责；不做自动调度、文件锁或并发冲突仲裁；不把 Cursor / Trae 的人工交付说成自动送达。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starwork update</code></strong></td>
+            <td>未来版本迁移命令。</td>
+            <td>面向已经是 StarWork 的工作台，处理未来基础结构和场景能力版本迁移。</td>
+            <td>未定。</td>
+            <td>未定。</td>
+            <td>与 <code>upgrade</code> 分开：update 不负责历史模板进入 StarWork。</td>
+            <td><span class="status planned">规划中</span></td>
+          </tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>Skill 注册表</h2>
+        <p class="section-note">这里列出 StarWork 自研 Skill。Skill 负责 AI 判断和方案生成，不直接替代 CLI。</p>
+      </div>
+      <table>
+        <thead>
+          <tr>
+            <th>Skill</th>
+            <th>定位</th>
+            <th>触发场景</th>
+            <th>主要能力</th>
+            <th>产出</th>
+            <th>对应 CLI</th>
+            <th>状态</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td><strong><code>starwork</code></strong></td>
+            <td>L0 主入口，全局系统 Skill。</td>
+            <td>用户询问 StarWork 产品、安装、怎么开始，或不知道该用哪个能力。</td>
+            <td>解释产品；引导安装；判断请求应进入初始化、诊断、知识库、多 Agent、项目中心还是收尾整理。</td>
+            <td>下一步建议、专家 Skill 路由、安装验证步骤。</td>
+            <td>按场景路由到 <code>starwork init</code>、<code>doctor</code>、<code>knowledge</code>、<code>multiagent</code> 等。</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkInit</code></strong></td>
+            <td>L1 系统专家：初始化设计助手。</td>
+            <td>用户想从 0 建工作台，但还没确定工作台类型、语言或目录偏好。</td>
+            <td>分支式采访；判断是 项目中心 还是普通项目；判断语言；生成初始化建议或 init blueprint；用户确认创建时继续执行 dry-run、写入和 doctor 验证。</td>
+            <td>初始化建议、<code>init-blueprint.json</code>、rules、dry-run / yes / doctor 执行结果。</td>
+            <td><code>starwork init</code> / <code>starwork init --blueprint</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkSpawn</code></strong></td>
+            <td>L2 Kit 自带：项目中心项目定制单设计助手。</td>
+            <td>用户已有项目中心，要创建一个新项目，并希望项目目录、规则或托管的 AI 使用说明可定制。</td>
+            <td>采访项目类型和工作方式；生成项目创建方案；整理项目规则和初始文件。</td>
+            <td><code>blueprint.json</code>、rules、初始文件、spawn dry-run 命令。</td>
+            <td><code>starwork spawn --blueprint</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkAudit</code></strong></td>
+            <td>L2 Kit 自带：项目中心巡检助手。</td>
+            <td>项目中心需要巡检项目登记、共享资源、项目工作台连接状态，或生成修复方案。</td>
+            <td>解释项目中心 audit 结果；识别项目登记和共享资源风险；生成可确认的 repair blueprint。</td>
+            <td>巡检解释、风险摘要、修复建议、<code>repair-blueprint.json</code>。</td>
+            <td><code>starwork audit</code> / <code>starwork repair --blueprint</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>neat-freak</code></strong></td>
+            <td>L2 Kit 自带：单项目整理收尾助手。</td>
+            <td>单项目工作台需要阶段性清理、项目记忆整理、收尾归档。</td>
+            <td>读取工作区规则和当前工作；检查产品事实、过程记录和当前任务是否归位；输出清理报告。</td>
+            <td>清理报告、必要的当前工作记录更新建议。</td>
+            <td><code>starwork init</code> 随 Kit 写入</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkDoctor</code></strong></td>
+            <td>L1 系统专家：工作区诊断助手。</td>
+            <td>用户要理解 doctor 输出、判断旧目录如何整理成 StarWork 工作台；或想无损生成升级方案。</td>
+            <td>读取 doctor JSON；解释目录清单和线索；建立目录角色映射；识别历史模板或 项目中心-like 旧主库；判断目录分工是否清楚；提出整理建议；用户确认后生成升级方案和规则文件。</td>
+            <td>诊断报告、目录角色映射、缺失和风险、确认问题、<code>upgrade-blueprint.json</code>、rules、dry-run 命令。</td>
+            <td><code>starwork doctor</code> / <code>starwork upgrade --blueprint</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkMultiagent</code></strong></td>
+            <td>L1 系统专家：多 AI 协作命令包装助手。</td>
+            <td>用户想把当前会话登记为常用智能体、管理 AI 职责位、绑定或释放 session、查看分工、登记共享输出、读取其他 lane 状态、向其他 lane 发指令或创建 lane thread。</td>
+            <td>判断用户语义；确认 lane ID、职责、写入范围、session、跨会话指令内容和回报方式；把请求翻译成 <code>multiagent init/add/bind/read/instruct/launch/status/share</code> 命令组合。</td>
+            <td>multiagent dry-run 命令、确认后的执行命令、当前分工解释、Codex host observation 解释、过程材料放置建议。</td>
+            <td><code>starwork multiagent</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkKnowledge</code></strong></td>
+            <td>L1 系统专家：项目知识库整理助手。</td>
+            <td>用户想开启知识库、整理资料、回答并沉淀长期知识、检查知识库是否混乱，或从旧知识目录整理到新结构。</td>
+            <td>先调用 <code>starwork knowledge</code> 创建或检查结构；判断哪些内容值得长期沉淀；维护 <code>pages/</code>、<code>synthesis/</code>、<code>index.md</code> 和 <code>log.md</code>；需要旧目录整理时生成 blueprint。项目开启知识库后，CLI 会把项目内业务 Skill <code>starworkKnowledgeProject</code> 安装到当前项目，它不属于全局系统 Skill。</td>
+            <td>知识库维护建议、主题页、综合判断、来源索引、维护记录、<code>starwork.knowledge</code> blueprint。</td>
+            <td><code>starwork knowledge</code></td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+          <tr>
+            <td><strong><code>starworkKnowledgeProject</code></strong></td>
+            <td>L3 Capability 项目内：知识库维护助手。</td>
+            <td>当前项目已经开启知识库能力，需要在项目内长期维护主题页、综合判断和来源索引。</td>
+            <td>按项目知识库规则整理稳定知识；维护主题页、综合判断、索引和维护记录；不作为全局系统 Skill 分发。</td>
+            <td><code>pages/</code>、<code>synthesis/</code>、<code>index.md</code>、<code>log.md</code> 更新建议或执行结果。</td>
+            <td><code>starwork knowledge</code> 能力开启后写入当前项目</td>
+            <td><span class="status done">已实现</span></td>
+          </tr>
+        </tbody>
+      </table>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>配合关系</h2>
+        <p class="section-note">最容易混淆的是 doctor / upgrade 这一组，以及 multiagent 的用户语义和 CLI 子命令。这里固定它们的链路。</p>
+      </div>
+      <div class="flow">
+        <div class="flow-step">
+          <strong>01</strong>
+          <span>探测</span>
+          <p><code>starwork doctor --json</code> 只暴露事实、目录清单、线索和检查结果。</p>
+        </div>
+        <div class="flow-step">
+          <strong>02</strong>
+          <span>诊断</span>
+          <p><code>starworkDoctor</code> 判断当前目录分工是否清楚，以及如何整理成 StarWork 工作台。</p>
+        </div>
+        <div class="flow-step">
+          <strong>03</strong>
+          <span>设计</span>
+          <p><code>starworkDoctor</code> 在用户确认后生成可执行的升级方案。</p>
+        </div>
+        <div class="flow-step">
+          <strong>04</strong>
+          <span>执行</span>
+          <p><code>starwork upgrade --blueprint</code> 只按方案执行低风险动作。</p>
+        </div>
+      </div>
+      <div class="callout">
+        <strong>固定边界：</strong>CLI 不硬猜业务语义；Skill 不静默改用户文件。所有会写入的 CLI 能力都应保留 dry-run 或明确确认。<code>multiagent init</code> 是协议初始化；“登记当前会话为常用智能体”在 Skill 层应解释为必要时先 init，再 add 和 bind。
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>常用命令</h2>
+        <p class="section-note">这些命令用于 A 测、演示和本地回归测试。</p>
+      </div>
+      <div class="grid-2">
+        <div>
+          <h3>初始化</h3>
+          <pre>starwork init --type project --pack general --target ./my-workspace --dry-run
+starwork init --type hub --target ./my-hub --yes</pre>
+        </div>
+        <div>
+          <h3>从项目中心创建项目</h3>
+          <pre>starwork spawn --hub ./my-hub --name "新项目" --target ./new-project --mode project --language zh --dry-run
+starwork spawn --hub ./my-hub --target ./new-project --blueprint ./blueprint.json --dry-run</pre>
+        </div>
+        <div>
+          <h3>检查与升级</h3>
+          <pre>starwork doctor --target ./old-workspace --json --inventory-depth all
+starwork upgrade --target ./old-workspace --blueprint ./upgrade-blueprint.json --dry-run</pre>
+        </div>
+        <div>
+          <h3>适配与安装场景能力</h3>
+          <pre>starwork adapt all --capabilities --json
+starwork adapt claude --target ./my-workspace --yes
+starwork pack install content-creator --target ./my-workspace --dry-run</pre>
+        </div>
+        <div>
+          <h3>多 AI 协作</h3>
+          <pre>starwork multiagent init --lanes research,writing,review --target ./my-workspace --yes
+starwork multiagent bind research --session codex:manual-research-1 --target ./my-workspace --yes
+starwork multiagent request record --from research --to review --message "请手动验收这份输出。" --host-delivery recorded_only --delivery-tool manual --target ./my-workspace --dry-run
+starwork multiagent handoff review --from research --message "请手动验收这份输出。" --target ./my-workspace --dry-run
+starwork multiagent continue research --target ./my-workspace --json
+starwork multiagent share research --title "Source notes draft" --path notes/source-notes.md --audience writing,review --target ./my-workspace --yes</pre>
+        </div>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>维护规则</h2>
+        <p class="section-note">这页后续要按时更新，建议作为发布前检查项。</p>
+      </div>
+      <table>
+        <thead>
+          <tr>
+            <th>触发条件</th>
+            <th>必须更新</th>
+            <th>检查方式</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td>新增、改名、删除 CLI 命令。</td>
+            <td>CLI 注册表、常用命令、文档中心入口。</td>
+            <td>运行 <code>starwork --help</code>，确认命令列表一致。</td>
+          </tr>
+          <tr>
+            <td>新增、改名、删除 Skill。</td>
+            <td>Skill 注册表、<code>product/skills/README.md</code>、npm 打包内容。</td>
+            <td>检查 <code>product/skills/*/SKILL.md</code> 和 <code>npm pack --dry-run</code>。</td>
+          </tr>
+          <tr>
+            <td>CLI 与 Skill 的分工变化。</td>
+            <td>配合关系、对应 CLI、边界说明。</td>
+            <td>确认是否仍符合“AI 判断，CLI 执行”。</td>
+          </tr>
+          <tr>
+            <td>发布新 npm alpha。</td>
+            <td>当前总览里的版本号和维护日期。</td>
+            <td>运行 <code>npm view @jennie-shawn/starwork version</code>。</td>
+          </tr>
+        </tbody>
+      </table>
+    </section>
+  </main>
+</body>
+</html>