@house365/comate 0.10.2 → 1.0.2-next.0

package/bin/init.mjs

@@ -1,19 +1,14 @@
-// `comate-skills init` — install comate's prerequisites, then comate itself.
-//
-// Three dependencies, each already has an installer we can drive:
-//   OpenSpec CLI  -> npm install -g @fission-ai/openspec@latest  (PATH command,
-//                    so always global regardless of the chosen skill scope)
-//   Superpowers   -> npx skills add obra/superpowers             (scope-aware)
-//   comate        -> npx skills add <this package>               (scope-aware)
+// `comate init` helpers. comate 1.0 has no external workflow dependencies: it
+// needs Node and git, installs its own skills through the pinned `skills` CLI,
+// and lays down the comate/ project scaffold.
 //
 // ponytail: no SKILLS_AGENT_MAP here. The skills CLI detects the running agent
 // on its own, so translating platform ids to agent names would be dead code.
 import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, readdirSync, copyFileSync, statSync, lstatSync, rmSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readdirSync, copyFileSync, statSync, lstatSync, renameSync, rmSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, join } from 'node:path';
 
-const MIN_OPENSPEC = '1.5.0';
 const NPM_TIMEOUT_MS = 180_000;
 const SKILLS_TIMEOUT_MS = 300_000;
 
@@ -141,63 +136,17 @@ function skillsInvocation(pkgRoot, args) {
   }
 }
 
-function openSpecState() {
-  // shell:true on Windows: npm installs this as openspec.cmd, which cannot be
-  // spawned directly. bashVersion needs no shell — it has a real executable path.
-  const version = capture('openspec', ['--version'], { shell: process.platform === 'win32' });
-  if (version === null) return { status: 'missing' };
-  return { status: atLeast(version, MIN_OPENSPEC) ? 'ready' : 'outdated', version };
-}
-
-// Detect skills CLI installation (flattens obra/superpowers into one dir per
-// skill) and Claude Code plugin installation (installed_plugins.json registry).
-const SUPERPOWERS_MARKERS = [
-  ['using-superpowers'],
-  ['brainstorming'],
-];
-
-function superpowersInstalled(scope) {
-  const home = process.env.HOME ?? process.env.USERPROFILE ?? '';
-  const roots =
-    scope === 'global'
-      ? ['.agents/skills', '.claude/skills', '.config/skills', '.cursor/skills']
-          .map((r) => join(home, r))
-      : ['.agents/skills', '.claude/skills', '.cursor/skills', '.codex/skills'];
-
-  // Check skills CLI installation
-  if (roots.some((root) => SUPERPOWERS_MARKERS.some((m) => existsSync(join(root, ...m))))) {
-    return true;
-  }
-
-  // Check Claude Code plugin installation (only for global scope - plugins are user-level)
-  if (scope === 'global') {
-    const pluginRegistry = join(home, '.claude', 'plugins', 'installed_plugins.json');
-    try {
-      const registry = JSON.parse(readFileSync(pluginRegistry, 'utf8'));
-      // Check if superpowers plugin is installed (any marketplace)
-      return Object.keys(registry.plugins || {}).some((key) =>
-        key.startsWith('superpowers@') && Array.isArray(registry.plugins[key]) && registry.plugins[key].length > 0
-      );
-    } catch {
-      // File doesn't exist or parse failed - not a plugin install
-      return false;
-    }
-  }
-
-  return false;
-}
-
-// The docs scaffold ships inside the comate skill, so it is present both in dev
-// (repo checkout) and after `skills add` copies the skill to ~/.agents/skills.
+// The comate/ scaffold ships inside the comate skill, so it is present both in
+// dev (repo checkout) and after `skills add` copies the skill to ~/.agents/skills.
 // Locating it relative to pkgRoot means init reads the same tree it packed.
 function scaffoldSourceDir(pkgRoot) {
-  return join(pkgRoot, 'skills', 'comate-gate', 'scaffold', 'docs');
+  return join(pkgRoot, 'skills', 'comate', 'scaffold', 'comate');
 }
 
 // copyTreeSkipExisting — recursively copy src→dst, never overwriting a file that
 // already exists. Returns { created, skipped } counts so init can report whether
-// it actually laid anything down (matching the openspec/ step's idempotence:
-// an existing docs/ is left alone, only missing pieces are filled in).
+// it actually laid anything down: an existing comate/ is left alone, only
+// missing pieces are filled in.
 function copyTreeSkipExisting(src, dst, acc = { created: 0, skipped: 0 }) {
   mkdirSync(dst, { recursive: true });
   for (const entry of readdirSync(src)) {
@@ -215,17 +164,45 @@ function copyTreeSkipExisting(src, dst, acc = { created: 0, skipped: 0 }) {
   return acc;
 }
 
-// scaffoldDocs — lay down docs/ (knowledge-base + architecture placeholder + PRD
-// template) so /comate-gate has somewhere to read PRDs from. comate_kb_root in
-// comate-lib.sh is hardcoded to docs/knowledge-base, so this path is not
-// configurable — it must match. Idempotent: existing files are never clobbered.
-function scaffoldDocs(pkgRoot, cwd = process.cwd()) {
+// scaffoldComate — lay down comate/ (config.json, knowledge-base with the PRD
+// template, architecture placeholder). The layout is fixed: comate.mjs looks for
+// comate/comate/config.json under the git root. Idempotent: existing files are
+// never clobbered.
+function scaffoldComate(pkgRoot, cwd = process.cwd()) {
   const src = scaffoldSourceDir(pkgRoot);
   if (!existsSync(src)) return { ok: false, reason: `scaffold source missing: ${src}` };
-  const { created, skipped } = copyTreeSkipExisting(src, join(cwd, 'docs'));
+  const { created, skipped } = copyTreeSkipExisting(src, join(cwd, 'comate'));
   return { ok: true, created, skipped };
 }
 
+// 0.x kept long-lived docs under docs/; 1.0 keeps everything under comate/.
+// Only these two directories move — the rest of docs/ belongs to the project.
+const LAYOUT_MOVES = [
+  ['docs/knowledge-base', 'comate/knowledge-base'],
+  ['docs/architecture', 'comate/architecture'],
+];
+
+// -> { moves: [{ from, to, status: 'move' | 'conflict' | 'moved' }], ok }.
+// git mv keeps history; a destination that already exists is a conflict and
+// nothing is moved at all, so a half-migrated tree never happens.
+function migrateLayout(cwd = process.cwd(), { dryRun = true } = {}) {
+  const moves = LAYOUT_MOVES.filter(([from]) => existsSync(join(cwd, from))).map(([from, to]) => ({
+    from,
+    to,
+    status: existsSync(join(cwd, to)) ? 'conflict' : 'move',
+  }));
+  const ok = moves.every((m) => m.status !== 'conflict');
+  if (dryRun || !ok) return { moves, ok };
+  const inGit = spawnSync('git', ['rev-parse', '--git-dir'], { cwd, stdio: 'ignore' }).status === 0;
+  for (const m of moves) {
+    mkdirSync(dirname(join(cwd, m.to)), { recursive: true });
+    const r = inGit ? spawnSync('git', ['mv', m.from, m.to], { cwd, encoding: 'utf8' }) : null;
+    if (!r || r.status !== 0) renameSync(join(cwd, m.from), join(cwd, m.to));
+    m.status = 'moved';
+  }
+  return { moves, ok };
+}
+
 // comate skill dirs that later releases renamed or dropped. `skills add` only
 // adds/overwrites, never removes, so without an explicit prune these linger in
 // ~/.agents/skills as dead slash commands (e.g. /comate-hotfix after it became
@@ -233,7 +210,13 @@ function scaffoldDocs(pkgRoot, cwd = process.cwd()) {
 // unrelated third-party skills (lark-*, openspec-*), so a prefix sweep or a
 // diff-against-current strategy could wipe a user's own work. Add a line here
 // whenever a comate skill is renamed or removed.
-const DEPRECATED_SKILLS = ['comate-hotfix', 'comate-tweak', 'comate-intake'];
+// 1.0: one /comate skill drives every phase through the Node state machine; the
+// per-phase skills (gate/spec/build/verify/fix) are gone.
+const DEPRECATED_SKILLS = [
+  'comate-hotfix', 'comate-tweak', 'comate-intake',
+  'comate-open', 'comate-design', 'comate-archive', 'comate-grill',
+  'comate-gate', 'comate-spec', 'comate-build', 'comate-verify', 'comate-fix',
+];
 
 function userSkillsRoot(home = process.env.HOME ?? process.env.USERPROFILE ?? '') {
   return join(home, '.agents', 'skills');
@@ -304,7 +287,6 @@ function syncComateSkills(pkgRoot, { home = process.env.HOME ?? process.env.USER
 }
 
 export {
-  MIN_OPENSPEC,
   NPM_TIMEOUT_MS,
   SKILLS_TIMEOUT_MS,
   findNpmCli,
@@ -315,11 +297,11 @@ export {
   run,
   capture,
   atLeast,
-  openSpecState,
-  superpowersInstalled,
   scaffoldSourceDir,
   copyTreeSkipExisting,
-  scaffoldDocs,
+  scaffoldComate,
+  migrateLayout,
+  LAYOUT_MOVES,
   DEPRECATED_SKILLS,
   userSkillsRoot,
   pruneDeprecatedSkills,

package/bin/postinstall.mjs

@@ -1,56 +1,56 @@
-#!/usr/bin/env node
-// Postinstall hook: show the wordmark and next steps after npm install finishes.
-// Skipped in CI (where the logo wouldn't render anyway) and local dev installs
-// (where the developer already knows what they installed).
-import { fileURLToPath } from 'node:url';
-import { dirname, resolve } from 'node:path';
-
-const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-
-// Skip in CI, or when installing the package's own dependencies during dev.
-if (isCI() || isDevInstall()) {
-  process.exit(0);
-}
-
-const { banner, pkgVersion } = await import('./init-run.mjs');
-
-// Best-effort: refresh the user-level skills so `npm i -g @latest` alone updates
-// them, and prune dirs renamed/dropped in past releases. All guarded — a failure
-// here must never break the npm install, and `comate init` remains the fallback
-// for --ignore-scripts users (who never reach this hook) and per-project setup.
-const sync = await syncSkillsQuietly();
-
-console.log(banner(pkgVersion(pkgRoot)));
-console.log(`  🎉 Congratulations! comate 已成功安装。\n`);
-if (sync.synced) console.log('  ✓ 已把 skills 同步到 ~/.agents/skills');
-if (sync.removed.length) console.log(`  ✓ 已清理废弃 skill：${sync.removed.join('、')}`);
-console.log('  下一步：');
-console.log('    在你的项目目录下运行  comate init  完成项目初始化（openspec/、docs/）');
-console.log('    或运行                comate doctor  健康检查');
-console.log('    更多帮助              comate --help\n');
-
-async function syncSkillsQuietly() {
-  try {
-    const { syncComateSkills, pruneDeprecatedSkills, userSkillsRoot } = await import('./init.mjs');
-    const { ok } = syncComateSkills(pkgRoot);
-    const removed = pruneDeprecatedSkills(userSkillsRoot());
-    return { synced: ok, removed };
-  } catch {
-    // Any failure (no skills CLI resolvable, fs error) is silent: init covers it.
-    return { synced: false, removed: [] };
-  }
-}
-
-function isCI() {
-  return Boolean(process.env.CI || process.env.GITHUB_ACTIONS);
-}
-
-// When npm installs a package's own dependencies (npm i in the repo itself),
-// INIT_CWD points to the package root. A user installing comate globally or as
-// a dependency has INIT_CWD pointing elsewhere.
-function isDevInstall() {
-  const initCwd = process.env.INIT_CWD;
-  if (!initCwd) return false;
-  const normalise = (p) => resolve(p).replace(/[\\/]+$/, '').toLowerCase();
-  return normalise(initCwd) === normalise(pkgRoot);
-}
+#!/usr/bin/env node
+// Postinstall hook: show the wordmark and next steps after npm install finishes.
+// Skipped in CI (where the logo wouldn't render anyway) and local dev installs
+// (where the developer already knows what they installed).
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+// Skip in CI, or when installing the package's own dependencies during dev.
+if (isCI() || isDevInstall()) {
+  process.exit(0);
+}
+
+const { banner, pkgVersion } = await import('./init-run.mjs');
+
+// Best-effort: refresh the user-level skills so `npm i -g @latest` alone updates
+// them, and prune dirs renamed/dropped in past releases. All guarded — a failure
+// here must never break the npm install, and `comate init` remains the fallback
+// for --ignore-scripts users (who never reach this hook) and per-project setup.
+const sync = await syncSkillsQuietly();
+
+console.log(banner(pkgVersion(pkgRoot)));
+console.log(`  🎉 Congratulations! comate 已成功安装。\n`);
+if (sync.synced) console.log('  ✓ 已把 skills 同步到 ~/.agents/skills');
+if (sync.removed.length) console.log(`  ✓ 已清理废弃 skill：${sync.removed.join('、')}`);
+console.log('  下一步：');
+console.log('    在你的项目目录下运行  comate init  完成项目初始化（comate/）');
+console.log('    或运行                comate doctor  健康检查');
+console.log('    更多帮助              comate --help\n');
+
+async function syncSkillsQuietly() {
+  try {
+    const { syncComateSkills, pruneDeprecatedSkills, userSkillsRoot } = await import('./init.mjs');
+    const { ok } = syncComateSkills(pkgRoot);
+    const removed = pruneDeprecatedSkills(userSkillsRoot());
+    return { synced: ok, removed };
+  } catch {
+    // Any failure (no skills CLI resolvable, fs error) is silent: init covers it.
+    return { synced: false, removed: [] };
+  }
+}
+
+function isCI() {
+  return Boolean(process.env.CI || process.env.GITHUB_ACTIONS);
+}
+
+// When npm installs a package's own dependencies (npm i in the repo itself),
+// INIT_CWD points to the package root. A user installing comate globally or as
+// a dependency has INIT_CWD pointing elsewhere.
+function isDevInstall() {
+  const initCwd = process.env.INIT_CWD;
+  if (!initCwd) return false;
+  const normalise = (p) => resolve(p).replace(/[\\/]+$/, '').toLowerCase();
+  return normalise(initCwd) === normalise(pkgRoot);
+}

package/docs/CHANGELOG-fix-simplification.md

@@ -0,0 +1,145 @@
+# fix 模式简化：原则而非清单
+
+**日期**: 2026-10-08  
+**改动范围**: `skills/comate/reference/fix.md`, `skills/comate/reference/open.md`, `skills/comate/SKILL.md`
+
+## 背景
+
+之前的 fix 模式虽然简化了 brief 结构（三章 vs 七章），但在澄清阶段仍然要求走九大视角的清单式检查。这对于边界清楚的小修来说过于繁重，限制了模型的自主判断能力。
+
+## 改动内容
+
+### 1. fix 模式采用原则驱动澄清
+
+**之前**：fix 模式在 open 阶段仍需逐项检查九大视角  
+**现在**：只需回答三个核心问题
+
+```markdown
+1. **修什么**（目标） — 现象、影响范围、复现方式
+2. **怎么验收**（验收示例） — 至少一条「修复后原问题不再出现」
+3. **为什么这样修**（决定） — 根因分析与修复方式
+```
+
+### 2. 按需查证而非强制清单
+
+**新增"何时需要查证"指引**：
+
+| 情况 | 处理方式 |
+|---|---|
+| 根因不明 | 先复现问题、定位根因，再写 brief |
+| 影响范围不确定 | 检查调用链、依赖关系，明确波及范围 |
+| 修复方案有多种 | 评估可逆性和副作用，选最小改动；不确定时问用户 |
+| 可能破坏已有行为 | 列出可能受影响的场景，验收示例必须包含回归检查 |
+
+**判断标准**：如果写完 brief 后发现"其实不太确定影响范围"或"可能有副作用但说不清"，那就是该查证的信号。
+
+### 3. full 模式九大视角增加快速判定指南
+
+在 `reference/open.md` 的九大视角表格中新增第三列"何时可快速标记'不适用'"：
+
+- **用户与场景**：纯内部技术重构、CLI 工具、开发者工具
+- **架构与边界**：单一模块内的局部改动，不涉及模块间交互
+- **旅程与状态**：无状态变更（纯查询、纯展示）
+- **数据与规则**：不涉及数据存储或传输（纯前端交互）
+- **风险与反例**：仅管理员可见、无外部输入、单机运行
+- 等等...
+
+标记"不适用"的判断标准：遗漏这一项**不会**导致返工或生产问题。
+
+### 4. 明确 fix 的适用场景和升级时机
+
+**适合 fix**：
+- 明确的 bug，能快速复现和定位
+- 影响范围清楚（单一模块或功能）
+- 修复方案直接（不涉及架构调整）
+- 改动文件少（bug 修复 ≤3 个文件，调整 ≤5 个文件）
+
+**升级为 full 的时机**：
+- 改动规模超出预期（涉及 3+ 文件或需改 schema/API/架构）
+- 影响范围扩大（需要新的用户可见行为）
+- 根因复杂（需要分阶段处理或产品决策）
+
+**边界不清时，默认用 full**。
+
+### 5. 增强验收要求
+
+明确 Bug 修复的验收**必须包含**：
+1. **正向验证** — 修复后原问题消失
+2. **回归验证** — 相关场景不受影响（列出具体场景）
+3. **边界验证** — 极值、空值、并发（按实际风险选择）
+
+## 设计理念
+
+### 从"清单驱动"到"原则驱动"
+
+**清单驱动**（full 模式）：
+- 优势：系统性覆盖，不遗漏关键维度
+- 劣势：认知负担重，可能过度工程，限制模型创造性
+
+**原则驱动**（fix 模式）：
+- 优势：轻量快速，信任模型判断，聚焦核心问题
+- 劣势：需要明确的边界判断能力
+
+### 平衡点
+
+- **fix 模式**：信任强模型在边界清楚时的快速决策能力
+- **full 模式**：保留系统性框架，用于复杂或高风险场景
+- **快速判定指南**：降低 full 模式的认知负担，避免为了填表而填表
+
+## 向后兼容性
+
+- **代码层面**：无破坏性变更，所有测试通过（26 个测试全部 pass）
+- **文档层面**：fix 模式行为不变（三章 brief + 免确认），只是澄清方式从隐式继承九大视角改为显式的原则驱动
+- **状态机**：`mode: fix` 的状态转换逻辑不变
+
+## 使用示例
+
+### fix 模式的 brief 示例
+
+```markdown
+# 目标
+
+用户在订单列表页滚动到底部时，点击「加载更多」无反应。
+影响范围：所有用户，订单超过 20 条时必现。
+复现：登录 → 订单列表 → 滚动到底部 → 点击「加载更多」→ 无反应。
+
+# 验收示例
+
+- 修复后，点击「加载更多」能正常加载下一页订单
+- 已加载全部订单时，「加载更多」按钮变灰且显示「已加载全部」
+- 回归：其他分页场景（商品列表、搜索结果）不受影响
+
+# 决定
+
+根因：分页请求的 offset 计算错误，`offset = page * pageSize` 应为 `offset = (page - 1) * pageSize`。
+修复方式：修正 `api/orders.js:45` 的 offset 计算公式。
+不改其他分页实现（已单独封装且行为正确）。
+```
+
+**注意**：没有走九大视角，但根因、影响范围、回归场景都明确了。
+
+## 未来展望
+
+可进一步考虑的方向：
+
+1. **分级策略**：增加 `--rigor standard|minimal|adaptive` 参数
+2. **澄清策略元能力**：在 open 开始前，先评估需求应该用什么澄清策略
+3. **动态调整**：根据过程中发现的复杂度，自动建议从 fix 升级到 full
+
+## 测试结果
+
+```bash
+npm test
+# ✔ fix 模式：prepare 直接进 build，可省 tasks.md (1102.3283ms)
+# ℹ tests 26
+# ℹ pass 26
+# ℹ fail 0
+```
+
+所有测试通过，包括 fix 模式的专项测试。
+
+## 参考
+
+- 借鉴 **Comet Native** 的"原则而非清单"设计
+- 参考 Ponytail 模式的"懒惰即高效"哲学
+- 保持与 full 模式的清晰边界，避免混淆

package/docs/COMATE_BETA.md

@@ -0,0 +1,90 @@
+# comate 1.0 试用说明
+
+1.0 使用单个 `/comate` skill 和 Node 状态机，流程为 open → build ⇄ verify → archive。相比 0.x，不再依赖 OpenSpec CLI 和 Superpowers 编排；项目资料统一放在 `comate/`，进行中的旧 change 不自动转换。
+
+## 安装与试用环境
+
+需要 Node.js ≥ 20、git，以及支持 skills 的 AI 开发工具。完整验收需要工具支持独立子 agent；不支持时，按流程明确接受降级验收。
+
+新版安装钩子和 `comate init` 会更新用户级 `~/.agents/skills`，并清理旧版 comate 阶段 skills。需要继续使用旧版的用户，请在独立系统用户、虚拟机或容器中试用。新 clone、worktree 和 `npx` 都不能隔离全局 skills。
+
+第一轮请使用新建的测试项目，或已有项目的独立测试副本；测试副本仍需配合独立用户环境来隔离 skills。旧版进行中的 change 请先用旧版完成。
+
+发布后安装试用渠道：
+
+```bash
+npm install -g @house365/comate@next
+cd your-test-project
+comate init
+comate doctor
+comate --version
+```
+
+本轮固定版本为 `1.0.0-beta.1`。需要复现本轮反馈时，用 `npm install -g @house365/comate@1.0.0-beta.1` 安装。
+
+在 AI 开发工具中新开会话，输入 `/comate` 开始。切换版本后请重新打开会话，避免沿用旧 skill 的上下文。
+
+## 建议试用任务
+
+每人选择一个能判断结果的小任务，至少跑完一次归档。建议覆盖：
+
+- 创建一个完整变更，确认需求、实现、独立验收、归档。
+- 用 fix 模式处理一个边界清楚的小修，检查澄清与实现是否顺畅。
+- 验收发现问题后，检查是否能回修并重新验收。
+- 中途关闭会话，重新输入 `/comate`，检查是否能恢复正确阶段。
+- 收尾选择 keep，检查主规格、归档目录和 git 状态。
+
+第一轮不要求迁移旧项目。`init --migrate` 和 `import-specs` 留到单独的迁移试用中，先用 `--dry-run` 检查清单，再决定是否执行。
+
+## 更新与回退
+
+更新试用版：
+
+```bash
+npm install -g @house365/comate@next
+cd your-test-project
+comate init
+```
+
+当前 `comate update` 固定跟随 `latest`，试用期间请使用上面的命令。
+
+需要恢复本次试用前的稳定版时：
+
+```bash
+npm install -g @house365/comate@0.10.3
+cd your-old-project
+comate init
+comate --version
+```
+
+这会恢复旧版 CLI 和 skills，但不会把新版 change 转回旧格式，也不会自动撤销目录迁移。回退后在旧项目继续工作，新版测试项目保留用于反馈；再次使用 AI 工具时新开会话。用户自行修改过的全局 skills，请在首次切换前另行备份。
+
+## 反馈
+
+通过 [GitHub Issues](https://github.com/liangjiankk/comate/issues) 提交，建议标题以 `[1.0 beta]` 开头，并提供：
+
+- `comate --version`、操作系统、Node 版本、AI 工具及模型。
+- 任务目标、发生问题的阶段、最短复现步骤。
+- 预期结果、实际结果，以及相关报错或 `comate status --json` 输出。
+- 本次哪些确认或操作造成了额外负担。
+
+只提供复现所需片段，提交前移除密钥、个人信息和项目敏感内容。
+
+## 维护者发布步骤
+
+稳定版继续在 `main` 维护并发布到 `latest`；新版在试用分支维护，发布到 `next`。当前包的 `publishConfig.tag` 默认设为 `next`，防止遗漏渠道参数时切换 `latest`。
+
+发布前将本轮试用涉及的代码和文档整理成一个可追踪的提交，检查其中包含预期内容，然后执行：
+
+```bash
+npm run prepublishOnly
+npm publish --dry-run --tag next
+npm run publish:next
+npm view @house365/comate dist-tags --json --registry=https://registry.npmjs.org
+```
+
+预期渠道为 `latest: 0.10.3`、`next: 1.0.0-beta.1`。实际发布需要 npm 账号拥有 `@house365/comate` 的发布权限，并按 npm 提示完成认证。
+
+后续每轮同步修改 `package.json` 和 `package-lock.json` 的版本，使用新的 `1.0.0-beta.N` 版本号，并更新本文的固定版本和预期渠道；已发布的版本不重复使用。
+
+正式发布时再移除默认的 `next` 配置、使用正式版本号、明确指定 `--tag latest`，并同步安装和更新说明。