@geminilight/mindos 0.6.28 → 0.6.30

package/bin/commands/space.js

@@ -1,10 +1,14 @@
 /**
- * mindos space — Mind Space management
+ * mindos space — Knowledge base structure management
+ *
+ * Manages the directory tree of the knowledge base.
+ * "Space" = directory + INSTRUCTION.md (AI context).
+ * All directory operations go here; file content ops go to `mindos file`.
  */
 
 import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, rmSync, renameSync } from 'node:fs';
-import { resolve, relative } from 'node:path';
-import { bold, dim, cyan, green, red } from '../lib/colors.js';
+import { resolve, basename } from 'node:path';
+import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
 import { loadConfig } from '../lib/config.js';
 import { output, isJsonMode, EXIT } from '../lib/command.js';
 
@@ -21,15 +25,18 @@ function getMindRoot() {
 export const meta = {
   name: 'space',
   group: 'Knowledge',
-  summary: 'Mind Space management (list, create, delete, rename, info)',
+  summary: 'Knowledge base structure (ls, mkdir, rmdir, init, info, tree)',
   usage: 'mindos space <subcommand>',
   examples: [
-    'mindos space list',
-    'mindos space list --json',
+    'mindos space ls',
+    'mindos space ls "📝 笔记"',
+    'mindos space tree',
+    'mindos space mkdir "📝 笔记/新分类"',
+    'mindos space rmdir "📝 笔记/旧分类"',
+    'mindos space init "exploration"',
+    'mindos space info "📝 笔记"',
     'mindos space create "Research"',
-    'mindos space delete "Old Project"',
     'mindos space rename "Old" "New"',
-    'mindos space info "Work"',
   ],
 };
 
@@ -39,48 +46,56 @@ export async function run(args, flags) {
 
   if (!sub || flags.help || flags.h) {
     console.log(`
-${bold('mindos space')} — Mind Space management
+${bold('mindos space')} — Knowledge base structure management
 
-${bold('Subcommands:')}
-  ${cyan('list'.padEnd(20))}${dim('List all spaces')}
-  ${cyan('create <name>'.padEnd(20))}${dim('Create a new space')}
-  ${cyan('delete <name>'.padEnd(20))}${dim('Delete a space and all its files')}
-  ${cyan('rename <old> <new>'.padEnd(20))}${dim('Rename a space')}
-  ${cyan('info <name>'.padEnd(20))}${dim('Show space details')}
+${bold('Browse:')}
+  ${cyan('ls [path]'.padEnd(24))}${dim('List contents of a directory (default: root)')}
+  ${cyan('tree [path]'.padEnd(24))}${dim('Show directory tree recursively')}
+  ${cyan('info <path>'.padEnd(24))}${dim('Show directory details (type, files, modified)')}
+
+${bold('Structure:')}
+  ${cyan('create <name>'.padEnd(24))}${dim('Create a new Space (directory + INSTRUCTION.md)')}
+  ${cyan('mkdir <path>'.padEnd(24))}${dim('Create a directory (no INSTRUCTION.md)')}
+  ${cyan('rmdir <path>'.padEnd(24))}${dim('Delete a directory and all its contents')}
+  ${cyan('rename <old> <new>'.padEnd(24))}${dim('Rename or move a directory')}
+  ${cyan('init <path>'.padEnd(24))}${dim('Upgrade a directory to a Space (add INSTRUCTION.md)')}
 
 ${bold('Examples:')}
-  ${dim('mindos space list')}
-  ${dim('mindos space create "Research"')}
-  ${dim('mindos space delete "Old Project"')}
-  ${dim('mindos space rename "Old" "New"')}
+  ${dim('mindos space ls')}
+  ${dim('mindos space ls "📝 笔记" --json')}
+  ${dim('mindos space tree "⚙️ 配置"')}
+  ${dim('mindos space mkdir "📝 笔记/新分类/子分类"')}
+  ${dim('mindos space init "exploration"')}
 `);
     return;
   }
 
   switch (sub) {
-    case 'list': return spaceList(root, flags);
-    case 'ls': return spaceList(root, flags);
+    case 'ls': case 'list': return spaceLs(root, args[1], flags);
+    case 'tree': return spaceTree(root, args[1], flags);
+    case 'info': return spaceInfo(root, args[1], flags);
     case 'create': return spaceCreate(root, args[1], flags);
-    case 'delete': case 'rm': return spaceDelete(root, args[1], flags);
+    case 'mkdir': return spaceMkdir(root, args[1], flags);
+    case 'rmdir': case 'rm': case 'delete': return spaceRmdir(root, args[1], flags);
     case 'rename': case 'mv': return spaceRename(root, args[1], args[2], flags);
-    case 'info': return spaceInfo(root, args[1], flags);
+    case 'init': case 'convert': return spaceInit(root, args[1], flags);
     default:
       console.error(red(`Unknown subcommand: ${sub}`));
-      console.error(dim('Available: list, create, delete, rename, info'));
-      process.exit(EXIT.ERROR);
+      console.error(dim('Available: ls, tree, info, create, mkdir, rmdir, rename, init'));
+      process.exit(EXIT.ARGS);
   }
 }
 
+// ── Helpers ────────────────────────────────────────────────────────────────────
+
 function isSpace(dir) {
-  // A space is a top-level directory that contains an INSTRUCTION.md
   return existsSync(resolve(dir, 'INSTRUCTION.md'));
 }
 
 function countFiles(dir) {
   let count = 0;
   try {
-    const entries = readdirSync(dir, { withFileTypes: true });
-    for (const e of entries) {
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
       if (e.name.startsWith('.')) continue;
       if (e.isFile()) count++;
       else if (e.isDirectory()) count += countFiles(resolve(dir, e.name));
@@ -89,133 +104,276 @@ function countFiles(dir) {
   return count;
 }
 
-function spaceList(root, flags) {
-  const entries = readdirSync(root, { withFileTypes: true });
+function resolvePath(root, relPath) {
+  const full = relPath ? resolve(root, relPath) : root;
+  if (!existsSync(full)) {
+    console.error(red(`Not found: ${relPath || '(root)'}`));
+    process.exit(EXIT.NOT_FOUND);
+  }
+  return full;
+}
+
+// ── ls: list contents of a directory ──────────────────────────────────────────
+
+function spaceLs(root, relPath, flags) {
+  const dir = resolvePath(root, relPath);
+  const entries = readdirSync(dir, { withFileTypes: true });
   const spaces = [];
+  const dirs = [];
+  const files = [];
 
   for (const e of entries) {
-    if (!e.isDirectory() || e.name.startsWith('.')) continue;
-    const full = resolve(root, e.name);
-    if (isSpace(full)) {
-      const fileCount = countFiles(full);
-      spaces.push({ name: e.name, path: e.name, fileCount });
+    if (e.name.startsWith('.')) continue;
+    const full = resolve(dir, e.name);
+    if (e.isDirectory()) {
+      const entry = { name: e.name, type: isSpace(full) ? 'space' : 'dir', fileCount: countFiles(full) };
+      (entry.type === 'space' ? spaces : dirs).push(entry);
+    } else if (e.isFile()) {
+      files.push({ name: e.name, type: 'file' });
     }
   }
 
   if (isJsonMode(flags)) {
-    output({ count: spaces.length, spaces }, flags);
+    output({ path: relPath || '.', entries: [...spaces, ...dirs, ...files] }, flags);
     return;
   }
 
-  if (spaces.length === 0) {
-    console.log(dim('No spaces found. Create one with: mindos space create "Name"'));
+  const label = relPath ? `${relPath}/` : 'Knowledge Base';
+  const total = spaces.length + dirs.length + files.length;
+  if (total === 0) {
+    console.log(dim(`\n${label} is empty.\n`));
     return;
   }
 
-  console.log(`\n${bold(`Spaces (${spaces.length}):`)}\n`);
+  console.log(`\n${bold(label)}\n`);
   for (const s of spaces) {
-    console.log(`  ${cyan(s.name.padEnd(30))}${dim(`${s.fileCount} files`)}`);
+    console.log(`  ${cyan(s.name + '/')}  ${dim(`[Space] ${s.fileCount} files`)}`);
+  }
+  for (const d of dirs) {
+    console.log(`  ${d.name}/  ${dim(`${d.fileCount} files`)}`);
+  }
+  for (const f of files) {
+    console.log(`  ${dim(f.name)}`);
+  }
+  if (dirs.length > 0 && !relPath) {
+    console.log(dim(`\n  Tip: \`mindos space init <name>\` to upgrade a directory to a Space`));
   }
   console.log();
 }
 
+// ── tree: recursive directory tree ────────────────────────────────────────────
+
+function spaceTree(root, relPath, flags) {
+  const dir = resolvePath(root, relPath);
+
+  if (isJsonMode(flags)) {
+    output({ path: relPath || '.', tree: buildTree(dir) }, flags);
+    return;
+  }
+
+  const label = relPath || 'Knowledge Base';
+  console.log(`\n${bold(label)}`);
+  printTree(dir, '');
+  console.log();
+}
+
+function buildTree(dir) {
+  const result = [];
+  try {
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+      if (e.name.startsWith('.')) continue;
+      const full = resolve(dir, e.name);
+      if (e.isDirectory()) {
+        result.push({ name: e.name, type: isSpace(full) ? 'space' : 'dir', children: buildTree(full) });
+      } else {
+        result.push({ name: e.name, type: 'file' });
+      }
+    }
+  } catch { /* skip */ }
+  return result;
+}
+
+function printTree(dir, prefix) {
+  let entries;
+  try { entries = readdirSync(dir, { withFileTypes: true }).filter(e => !e.name.startsWith('.')); }
+  catch { return; }
+
+  entries.forEach((e, i) => {
+    const isLast = i === entries.length - 1;
+    const connector = isLast ? '└── ' : '├── ';
+    const full = resolve(dir, e.name);
+    if (e.isDirectory()) {
+      const tag = isSpace(full) ? cyan(' [Space]') : '';
+      console.log(`${prefix}${connector}${e.name}/${tag}`);
+      printTree(full, prefix + (isLast ? '    ' : '│   '));
+    } else {
+      console.log(`${prefix}${connector}${dim(e.name)}`);
+    }
+  });
+}
+
+// ── info ──────────────────────────────────────────────────────────────────────
+
+function spaceInfo(root, relPath, flags) {
+  if (!relPath) {
+    console.error(red('Usage: mindos space info <path>'));
+    process.exit(EXIT.ARGS);
+  }
+  const dir = resolvePath(root, relPath);
+  const stat = statSync(dir);
+  if (!stat.isDirectory()) {
+    console.error(red(`Not a directory: ${relPath}. Use \`mindos file read\` for files.`));
+    process.exit(EXIT.ARGS);
+  }
+
+  const fileCount = countFiles(dir);
+  const subdirs = readdirSync(dir, { withFileTypes: true }).filter(e => e.isDirectory() && !e.name.startsWith('.')).length;
+  const space = isSpace(dir);
+
+  const info = { name: basename(relPath), path: relPath, type: space ? 'space' : 'dir', fileCount, subdirs, modified: stat.mtime.toISOString() };
+
+  if (isJsonMode(flags)) {
+    output(info, flags);
+    return;
+  }
+
+  console.log(`\n${bold(relPath)}\n`);
+  console.log(`  ${dim('Type:'.padEnd(15))}${space ? cyan('Space') : 'Directory'}`);
+  console.log(`  ${dim('Files:'.padEnd(15))}${fileCount}`);
+  console.log(`  ${dim('Subdirs:'.padEnd(15))}${subdirs}`);
+  console.log(`  ${dim('Modified:'.padEnd(15))}${info.modified}`);
+  if (!space) {
+    console.log(`\n  ${dim('Tip: `mindos space init "' + relPath + '"` to upgrade to a Space')}`);
+  }
+  console.log();
+}
+
+// ── create: new Space (dir + INSTRUCTION.md) ──────────────────────────────────
+
 function spaceCreate(root, name, flags) {
   if (!name) {
     console.error(red('Usage: mindos space create <name>'));
-    process.exit(EXIT.ERROR);
+    process.exit(EXIT.ARGS);
   }
   const dir = resolve(root, name);
   if (existsSync(dir)) {
-    console.error(red(`Space already exists: ${name}`));
+    console.error(red(`Already exists: ${name}`));
     process.exit(EXIT.ERROR);
   }
 
   mkdirSync(dir, { recursive: true });
-  writeFileSync(resolve(dir, 'INSTRUCTION.md'), `# ${name}\n\nSpace instructions go here.\n`, 'utf-8');
+  writeFileSync(resolve(dir, 'INSTRUCTION.md'), `# ${basename(name)}\n\nSpace instructions go here.\n`, 'utf-8');
+  writeFileSync(resolve(dir, 'README.md'), `# ${basename(name)}\n`, 'utf-8');
 
   if (isJsonMode(flags)) {
-    output({ ok: true, name, path: name }, flags);
+    output({ ok: true, name, type: 'space' }, flags);
     return;
   }
-  console.log(`${green('✔')} Created space: ${cyan(name)}`);
+  console.log(`${green('✔')} Created Space: ${cyan(name)}`);
 }
 
-function spaceDelete(root, name, flags) {
-  if (!name) {
-    console.error(red('Usage: mindos space delete <name>'));
-    process.exit(EXIT.ERROR);
+// ── mkdir: plain directory ────────────────────────────────────────────────────
+
+function spaceMkdir(root, relPath, flags) {
+  if (!relPath) {
+    console.error(red('Usage: mindos space mkdir <path>'));
+    process.exit(EXIT.ARGS);
   }
-  const dir = resolve(root, name);
-  if (!existsSync(dir)) {
-    console.error(red(`Space not found: ${name}`));
-    process.exit(EXIT.ERROR);
+  const full = resolve(root, relPath);
+  if (existsSync(full)) {
+    if (isJsonMode(flags)) {
+      output({ ok: true, path: relPath, created: false }, flags);
+      return;
+    }
+    console.log(dim(`Already exists: ${relPath}`));
+    return;
   }
 
+  mkdirSync(full, { recursive: true });
+
+  if (isJsonMode(flags)) {
+    output({ ok: true, path: relPath, created: true }, flags);
+    return;
+  }
+  console.log(`${green('✔')} Created directory: ${cyan(relPath)}`);
+}
+
+// ── rmdir: delete directory ───────────────────────────────────────────────────
+
+function spaceRmdir(root, relPath, flags) {
+  if (!relPath) {
+    console.error(red('Usage: mindos space rmdir <path>'));
+    process.exit(EXIT.ARGS);
+  }
+  const dir = resolvePath(root, relPath);
   const fileCount = countFiles(dir);
   rmSync(dir, { recursive: true, force: true });
 
   if (isJsonMode(flags)) {
-    output({ ok: true, name, deletedFiles: fileCount }, flags);
+    output({ ok: true, path: relPath, deletedFiles: fileCount }, flags);
     return;
   }
-  console.log(`${green('✔')} Deleted space: ${cyan(name)} (${fileCount} files removed)`);
+  console.log(`${green('✔')} Deleted: ${cyan(relPath)} (${fileCount} files removed)`);
 }
 
-function spaceRename(root, oldName, newName, flags) {
-  if (!oldName || !newName) {
-    console.error(red('Usage: mindos space rename <old-name> <new-name>'));
-    process.exit(EXIT.ERROR);
-  }
-  const oldDir = resolve(root, oldName);
-  const newDir = resolve(root, newName);
-  if (!existsSync(oldDir)) {
-    console.error(red(`Space not found: ${oldName}`));
-    process.exit(EXIT.ERROR);
+// ── rename ────────────────────────────────────────────────────────────────────
+
+function spaceRename(root, oldPath, newPath, flags) {
+  if (!oldPath || !newPath) {
+    console.error(red('Usage: mindos space rename <old-path> <new-path>'));
+    process.exit(EXIT.ARGS);
   }
+  const oldDir = resolvePath(root, oldPath);
+  const newDir = resolve(root, newPath);
   if (existsSync(newDir)) {
-    console.error(red(`Target already exists: ${newName}`));
+    console.error(red(`Target already exists: ${newPath}`));
     process.exit(EXIT.ERROR);
   }
 
+  // Ensure parent of target exists
+  const parentDir = resolve(newDir, '..');
+  if (!existsSync(parentDir)) mkdirSync(parentDir, { recursive: true });
+
   renameSync(oldDir, newDir);
 
   if (isJsonMode(flags)) {
-    output({ ok: true, from: oldName, to: newName }, flags);
+    output({ ok: true, from: oldPath, to: newPath }, flags);
     return;
   }
-  console.log(`${green('✔')} Renamed space: ${cyan(oldName)} → ${cyan(newName)}`);
+  console.log(`${green('✔')} Renamed: ${cyan(oldPath)} → ${cyan(newPath)}`);
 }
 
-function spaceInfo(root, name, flags) {
-  if (!name) {
-    console.error(red('Usage: mindos space info <name>'));
-    process.exit(EXIT.ERROR);
+// ── init: upgrade directory to Space ──────────────────────────────────────────
+
+function spaceInit(root, relPath, flags) {
+  if (!relPath) {
+    console.error(red('Usage: mindos space init <path>'));
+    process.exit(EXIT.ARGS);
   }
-  const dir = resolve(root, name);
+  const dir = resolve(root, relPath);
+
+  // If doesn't exist, create it + init as Space
   if (!existsSync(dir)) {
-    console.error(red(`Space not found: ${name}`));
-    process.exit(EXIT.ERROR);
+    mkdirSync(dir, { recursive: true });
   }
 
-  const fileCount = countFiles(dir);
-  const stat = statSync(dir);
+  if (isSpace(dir)) {
+    if (isJsonMode(flags)) {
+      output({ ok: true, path: relPath, initialized: false, message: 'already a Space' }, flags);
+      return;
+    }
+    console.log(dim(`Already a Space: ${relPath}`));
+    return;
+  }
 
-  const info = {
-    name,
-    path: name,
-    fileCount,
-    isSpace: isSpace(dir),
-    modified: stat.mtime.toISOString(),
-  };
+  writeFileSync(resolve(dir, 'INSTRUCTION.md'), `# ${basename(relPath)}\n\nSpace instructions go here.\n`, 'utf-8');
+  if (!existsSync(resolve(dir, 'README.md'))) {
+    writeFileSync(resolve(dir, 'README.md'), `# ${basename(relPath)}\n`, 'utf-8');
+  }
 
   if (isJsonMode(flags)) {
-    output(info, flags);
+    output({ ok: true, path: relPath, initialized: true }, flags);
     return;
   }
-
-  console.log(`\n${bold(`Space: ${name}`)}\n`);
-  console.log(`  ${dim('Files:'.padEnd(15))}${fileCount}`);
-  console.log(`  ${dim('Is Space:'.padEnd(15))}${info.isSpace ? green('yes') : 'no (folder)'}`);
-  console.log(`  ${dim('Modified:'.padEnd(15))}${info.modified}`);
-  console.log();
+  console.log(`${green('✔')} Initialized Space: ${cyan(relPath)}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.6.28",
+  "version": "0.6.30",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",

package/templates/en/.mindos/workflows/Sprint Release.flow.yaml

@@ -0,0 +1,130 @@
+title: Sprint Release Workflow
+description: Weekly sprint release process with multi-agent collaboration and comprehensive QA
+
+# Global configuration - skills available across all steps
+skills:
+  - software-architecture
+  - code-review-quality
+  - document-release
+
+# Global tools guidance (advisory - LLM auto-selects based on context)
+tools:
+  - git
+  - npm
+  - github
+
+# Workflow steps - executed sequentially
+steps:
+  # Step 1: Run comprehensive test suite
+  - id: run_tests
+    name: Run tests
+    description: Execute full test suite and report results with coverage metrics
+    agent: cursor
+    prompt: |
+      Execute the full test suite for this project.
+      
+      Provide:
+      1. Total tests run, passed, failed
+      2. Coverage report (lines/branches/functions)
+      3. Any critical failures with recommendations
+      4. Time taken
+      
+      If failures exist, list the top 3 most critical with suggested fixes.
+    timeout: 120
+
+  # Step 2: Code review with dedicated AI agent
+  - id: code_review
+    name: Code review
+    description: Comprehensive code review using software architecture principles
+    agent: claude-code
+    skill: code-review-quality
+    prompt: |
+      Review the recent code changes using the code-review-quality standard.
+      
+      Evaluate:
+      1. Correctness - error handling, edge cases
+      2. Security - authentication, input validation, secrets
+      3. Performance - N+1 queries, caching, complexity
+      4. Maintainability - naming, tests, documentation
+      5. Architecture - follows project patterns, no anti-patterns
+      
+      Provide a rating (e.g., 8.5/10) and key recommendations.
+    timeout: 120
+
+  # Step 3: Automated security scan (no agent - use LLM with tools)
+  - id: security_check
+    name: Security scan
+    description: Run security analysis and dependency checks
+    tools:
+      - npm
+      - github
+    prompt: |
+      Perform security checks on this project:
+      
+      1. Check for known vulnerabilities in npm dependencies
+      2. Review recent dependency changes
+      3. Check for hardcoded secrets or credentials
+      4. Evaluate access control and authentication mechanisms
+      5. Assess error handling for information leaks
+      
+      Report severity and recommended fixes.
+    timeout: 60
+
+  # Step 4: Update documentation using document-release skill
+  - id: update_docs
+    name: Update documentation
+    description: Sync CHANGELOG, README, and API docs with shipped changes
+    skill: document-release
+    prompt: |
+      Update project documentation based on the shipped changes:
+      
+      1. Update CHANGELOG.md following semantic versioning
+      2. Update README.md if features or APIs changed
+      3. Update API documentation if endpoints changed
+      4. Verify all documentation links are valid
+      5. Check code examples match current implementation
+      
+      Provide a summary of all documentation updates made.
+    timeout: 60
+
+  # Step 5: Final checklist before release
+  - id: pre_release_check
+    name: Pre-release verification
+    description: Final comprehensive verification before shipping
+    agent: mindos
+    prompt: |
+      Perform final pre-release verification:
+      
+      Checklist:
+      ☐ All tests passing
+      ☐ Code review completed and issues resolved
+      ☐ Security scan passed or risks accepted
+      ☐ Documentation updated and links valid
+      ☐ Version bumped correctly (semver)
+      ☐ Git tags and commits clean
+      ☐ No uncommitted changes
+      ☐ Changelog entry present
+      ☐ Dependencies updated and locked
+      ☐ Performance benchmarks acceptable
+      
+      Confirm release readiness or list any blockers.
+    timeout: 60
+
+  # Step 6: Create release tag and prepare release notes
+  - id: create_release
+    name: Create release
+    description: Tag release and prepare release notes for publishing
+    tools:
+      - git
+      - npm
+    prompt: |
+      Prepare the project for release:
+      
+      1. Confirm version in package.json matches intended release
+      2. Create git tag for this version (vX.Y.Z)
+      3. Generate release notes from CHANGELOG.md
+      4. Prepare npm release command (do not execute yet)
+      5. List all deliverables included in this release
+      
+      Provide step-by-step commands for final publishing.
+    timeout: 60

package/templates/zh/.mindos/workflows//345/221/250/350/277/255/344/273/243/346/243/200/346/237/245.flow.yaml

@@ -0,0 +1,84 @@
+title: 周迭代检查工作流
+description: 每周进行代码审查、测试运行和文档更新的标准工作流
+
+# 全局配置 - 此工作流可用的技能
+skills:
+  - software-architecture
+  - code-review-quality
+
+# 工作流步骤 - 按顺序执行
+steps:
+  # 第 1 步：运行测试套件
+  - id: run_tests
+    name: 运行测试
+    description: 执行完整测试套件并报告覆盖率
+    agent: cursor
+    prompt: |
+      执行此项目的完整测试套件。
+      
+      提供以下信息：
+      1. 运行的总测试数、通过数、失败数
+      2. 覆盖率报告（行/分支/函数）
+      3. 任何严重失败及修复建议
+      4. 耗时
+      
+      如果有失败，列出前 3 个最严重的失败及建议的修复方案。
+    timeout: 120
+
+  # 第 2 步：代码审查
+  - id: code_review
+    name: 代码审查
+    description: 使用标准进行代码审查
+    agent: claude-code
+    skill: code-review-quality
+    prompt: |
+      使用代码审查标准对最近的代码变更进行审查。
+      
+      评估以下方面：
+      1. 正确性 - 错误处理、边界情况
+      2. 安全性 - 认证、输入验证、密钥管理
+      3. 性能 - 查询优化、缓存策略、复杂度
+      4. 可维护性 - 命名规范、测试覆盖、文档完整性
+      5. 架构 - 是否遵循项目模式，有无反模式
+      
+      给出评分（如 8.5/10）和主要建议。
+    timeout: 120
+
+  # 第 3 步：更新文档
+  - id: update_docs
+    name: 更新文档
+    description: 同步 CHANGELOG 和 README
+    skill: document-release
+    prompt: |
+      根据本次发布的变更更新项目文档：
+      
+      1. 更新 CHANGELOG.md，遵循语义化版本规范
+      2. 如果功能或 API 变更，更新 README.md
+      3. 如果端点变更，更新 API 文档
+      4. 验证所有文档链接有效
+      5. 检查代码示例是否匹配当前实现
+      
+      提供所有文档变更的摘要。
+    timeout: 60
+
+  # 第 4 步：发布前最终检查
+  - id: final_check
+    name: 发布前验证
+    description: 最终确认一切就绪
+    agent: mindos
+    prompt: |
+      进行最终的发布前验证检查：
+      
+      清单：
+      ☐ 所有测试通过
+      ☐ 代码审查完成并问题已解决
+      ☐ 文档已更新并链接有效
+      ☐ 版本号正确升级（语义化版本）
+      ☐ Git 标签和提交干净
+      ☐ 无未提交的更改
+      ☐ CHANGELOG 条目存在
+      ☐ 依赖项已更新并锁定
+      ☐ 性能基准可接受
+      
+      确认发布就绪或列出任何阻碍因素。
+    timeout: 60