@andyqiu/teamkit 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# teamkit
+
+> **teamkit — Team-level shared OpenCode plugin for KH integration and beyond**
+
+teamkit 是面向整个项目组的 [OpenCode](https://opencode.ai) 共享插件。它把团队知识库（KH）的深度集成能力从 CodeForge（程序员专属工具）中剥离出来，让策划、美术、数据等所有角色只需一行安装命令，就能在自己的 AI Agent 里自动获得：
+
+- **KH 触发词检测 + 自动召回**：遇到"怎么部署 / 以前 / 为什么"等 30+ 触发词时自动搜索团队知识库
+- **对话自动沉淀**：修完 bug / 做决策 / 踩到坑，自动写入 KH，全团队共享
+- **长对话效果保证**：三层机制（working_memory 注入 / compaction 兜底 / AGENTS.md marker）确保上下文不丢失
+
+> 📖 完整产品需求与设计决策见 **[docs/prd.md](docs/prd.md)**
+
+---
+
+## 安装
+
+```bash
+# 设计目标命令（包发布后生效）
+npx @andyqiu/teamkit install --global
+```
+
+安装脚本做三件事：
+1. 把 teamkit plugin entry 注册到 OpenCode 全局配置
+2. 写入 `teamkit.json` 配置文件
+3. 在 `AGENTS.md` 注入 `<!-- knowledge-hub:start/end -->` 行为约束块
+
+---
+
+## 与 CodeForge 的关系
+
+| | CodeForge | teamkit |
+|---|---|---|
+| 目标用户 | 程序员 | 全团队（程序 / 策划 / 美术 / 数据） |
+| 形态 | agent + plugin + command + tool | **仅 plugin**（纯后台，无 agent） |
+| KH 集成 | ✅（消费 teamkit 提供的能力） | ✅（提供方） |
+| 安装依赖 | 包级零 import；Phase 2 后 KH 能力运行时依赖 teamkit | 不依赖 CodeForge |
+
+装了 teamkit 之后，CodeForge 通过标准 working_memory topic 协议无缝获得 KH 能力。**包级零 import 依赖**；Phase 2 切换后 CodeForge 的 KH 能力在运行时依赖 teamkit 提供。
+
+---
+
+## 目录结构
+
+```
+teamkit/
+├── docs/             # PRD / 架构 / ADR / 兼容矩阵 / 验收套件
+├── plugins/          # OpenCode plugin .ts 文件（Phase 1 搬迁）
+├── lib/              # 共享工具库（Phase 1 搬迁）
+├── context-templates/# team-conventions.md 等注入模板（Phase 1）
+├── scripts/          # merge-agents-md.mjs / capability-detect / doctor
+├── tests/            # 单元测试 + 验收套件
+├── bin/              # teamkit / teamkit-doctor CLI
+└── install.sh        # 一键安装（全平台）
+```
+
+> ⚠️ **当前为 Phase 0**：代码目录均为占位（`.gitkeep`），Phase 1 才正式搬迁代码。
+
+---
+
+## Roadmap
+
+| 阶段 | 内容 |
+|---|---|
+| **Phase 0**（当前）| 仓库骨架 + 完整文档 + ADR 占位 |
+| **Phase 1** | 整文件搬迁 **4 plugin**（kh-reminder / compaction-guard / kh-auto-context / auto-learning）+ 4 lib + capability-detect + doctor + install.sh |
+| **Phase 2** | 与 CodeForge 仓库协同切换（CodeForge 退化为消费方） |
+| **Phase 3** | CI matrix + verification suite 自动化 |
+
+---
+
+## License
+
+MIT © Andy

package/agents/teamkit-git.md

@@ -0,0 +1,42 @@
+---
+name: teamkit-git
+description: 团队 Git 操作专属子代理。任意角色看到 git 触发词时通过 Task tool 自动调用。
+hidden: true
+tools:
+  bash: true
+  read: true
+  write: false
+  edit: false
+  webfetch: false
+---
+
+<!-- ADR: git-subagent-architecture -->
+
+你是 teamkit-git 子代理，专门负责安全地代用户操作 git。
+
+## 必须遵守的硬约束
+
+1. 永远先 `git rev-parse --show-toplevel` 确认仓库根
+2. 永远先 `git status` 和 `git branch --show-current` 采集现状
+3. 在 main 分支阻止 commit，引导新建分支
+4. git add 前 grep 敏感模式（AWS_KEY / PRIVATE_KEY / password= / token= / .env）
+5. git add 前列出大文件（>lfsThresholdMB），命中则拒绝直到用户确认
+6. **绝不**自动跑：reset --hard / push --force / branch -D / clean -fd / rebase main / 删远端分支
+7. **绝不**自动解决 merge 冲突——切冲突模式让用户拍板
+
+## 6 阶段流程
+
+1. 识别意图（提交/推送/分支/合并/撤销）
+2. 采集上下文（status / branch / diff --stat）
+3. 读规范（先读 `.teamkit/git-rules.json`，再 smart_search "本项目 git 规范"）
+4. 生成方案（commit message 草稿 / 分支名建议）
+5. 用户确认
+6. 执行 + 返回结果摘要
+
+## 输出格式
+
+每次结束返回给主 agent：
+- 执行的命令列表
+- commit hash（如有）
+- 当前分支 + 远端状态
+- 用户后续建议（如"建议拉一下 main"）

package/bin/teamkit-doctor.mjs

@@ -0,0 +1,320 @@
+#!/usr/bin/env node
+/**
+ * bin/teamkit-doctor.mjs — teamkit 诊断命令
+ *
+ * 诊断覆盖（PRD §4.5 R15）：
+ *   1. opencode 版本
+ *   2. experimental.session.compacting hook 可用性
+ *   3. KH MCP 可达性（超时 3s）
+ *   4. AGENTS.md marker 状态（<!-- knowledge-hub:start/end --> + <!-- teamkit-git:start/end -->）
+ *   5. Git Agent 加载状态（agents/teamkit-git.md + hidden: true）
+ *   6. .teamkit/git-rules.json 合法性
+ *   7. KH 静默失效诊断（CodeForge 未装 teamkit 的场景）
+ *
+ * ADR: opencode-version-compatibility
+ */
+
+import { readFileSync, existsSync } from "node:fs"
+import { join, resolve } from "node:path"
+import { homedir } from "node:os"
+import { execSync } from "node:child_process"
+import { createRequire } from "node:module"
+import process from "node:process"
+
+const HOME = homedir()
+const OPENCODE_CONFIG_DIR = join(HOME, ".config", "opencode")
+const OPENCODE_JSON_PATH = join(OPENCODE_CONFIG_DIR, "opencode.json")
+const AGENTS_MD_PATH = join(OPENCODE_CONFIG_DIR, "AGENTS.md")
+
+// 当前包根目录（从 bin/ 向上一级）
+const PKG_ROOT = resolve(new URL(".", import.meta.url).pathname, "..")
+
+const require = createRequire(import.meta.url)
+
+// ─── 工具函数 ──────────────────────────────────────────────────────────────────
+
+function ok(label, detail = "") {
+  process.stdout.write(`  ✅ ${label}${detail ? "  " + detail : ""}\n`)
+}
+
+function fail(label, detail = "") {
+  process.stdout.write(`  ❌ ${label}${detail ? "  " + detail : ""}\n`)
+}
+
+function warn(label, detail = "") {
+  process.stdout.write(`  ⚠️  ${label}${detail ? "  " + detail : ""}\n`)
+}
+
+function section(title) {
+  process.stdout.write(`\n── ${title} ──\n`)
+}
+
+// ─── 诊断 1：opencode 版本 ────────────────────────────────────────────────────
+function diagOpenCodeVersion() {
+  section("opencode 版本")
+  try {
+    const ver = execSync("opencode --version", { stdio: "pipe", timeout: 5000 })
+      .toString()
+      .trim()
+    ok("opencode CLI 可用", ver)
+    return ver
+  } catch {
+    // 尝试读 package.json
+    const pkgPaths = [
+      join(OPENCODE_CONFIG_DIR, "package.json"),
+      join(HOME, ".local", "share", "opencode", "package.json"),
+    ]
+    for (const p of pkgPaths) {
+      if (existsSync(p)) {
+        try {
+          const pkg = JSON.parse(readFileSync(p, "utf8"))
+          ok("opencode 版本（package.json）", `v${pkg.version}`)
+          return pkg.version
+        } catch { /* 继续 */ }
+      }
+    }
+    fail("opencode CLI 不可用", "请安装 opencode：https://opencode.ai")
+    return null
+  }
+}
+
+// ─── 诊断 2：experimental.session.compacting hook ────────────────────────────
+function diagSessionCompacting() {
+  section("experimental.session.compacting hook")
+  try {
+    const mod = require("@opencode-ai/plugin")
+
+    const hasHook = (
+      mod?.experimental?.session?.compacting !== undefined ||
+      (typeof mod?.hooks?.probe === "function" && (() => { try { mod.hooks.probe("experimental.session.compacting"); return true } catch { return false } })()) ||
+      (Array.isArray(mod?.HOOK_NAMES ?? mod?.SUPPORTED_HOOKS ?? mod?.hookNames) && (mod?.HOOK_NAMES ?? mod?.SUPPORTED_HOOKS ?? mod?.hookNames).includes("experimental.session.compacting"))
+    )
+
+    if (hasHook) {
+      ok("experimental.session.compacting hook 可用")
+    } else {
+      // 包存在但探测不到精确字段 → Phase 1 乐观
+      warn("experimental.session.compacting 无法精确探测", "Phase 1 乐观通过（见 ADR opencode-version-compatibility）")
+    }
+  } catch {
+    // 包不存在，用 CLI 版本推断
+    try {
+      execSync("opencode --version", { stdio: "pipe", timeout: 5000 })
+      warn("@opencode-ai/plugin 未安装", "opencode CLI 可用，推断 hook 可用（Phase 1）")
+    } catch {
+      fail(
+        "experimental.session.compacting hook 不可用",
+        "请升级 OpenCode 至支持 experimental.session.compacting hook 的版本"
+      )
+    }
+  }
+}
+
+// ─── 诊断 3：KH MCP 可达性 ────────────────────────────────────────────────────
+async function diagKhMcp() {
+  section("KH MCP 可达性")
+  // 通过调用一次 smart_search 来探测 KH MCP（超时 3s）
+  // Phase 1：MCP 通过 opencode plugin API 暴露，独立进程中无法直接调用
+  // 改为检测 MCP 配置是否存在
+  try {
+    const cfg = existsSync(OPENCODE_JSON_PATH)
+      ? JSON.parse(readFileSync(OPENCODE_JSON_PATH, "utf8"))
+      : {}
+
+    const mcpServers = cfg?.mcp ?? cfg?.mcpServers ?? {}
+    const hasKhMcp = Object.keys(mcpServers).some(
+      (k) => k.toLowerCase().includes("knowledge") || k.toLowerCase().includes("kh")
+    )
+
+    if (hasKhMcp) {
+      ok("KH MCP 配置已找到", `（server: ${Object.keys(mcpServers).find((k) => k.toLowerCase().includes("knowledge") || k.toLowerCase().includes("kh"))}）`)
+    } else {
+      warn("KH MCP 配置未找到", "如需 KH 功能，请配置 knowledge-hub MCP server")
+    }
+  } catch (err) {
+    fail("KH MCP 配置读取失败", err.message)
+  }
+}
+
+// ─── 诊断 4：AGENTS.md marker 状态 ───────────────────────────────────────────
+function diagAgentsMdMarkers() {
+  section("AGENTS.md marker 状态")
+
+  if (!existsSync(AGENTS_MD_PATH)) {
+    fail("~/.config/opencode/AGENTS.md 不存在", "运行 install.sh 创建")
+    return
+  }
+
+  let content
+  try {
+    content = readFileSync(AGENTS_MD_PATH, "utf8")
+  } catch (err) {
+    fail("AGENTS.md 读取失败", err.message)
+    return
+  }
+
+  // 检测 knowledge-hub markers
+  const hasKhStart = content.includes("<!-- knowledge-hub:start -->")
+  const hasKhEnd = content.includes("<!-- knowledge-hub:end -->")
+  if (hasKhStart && hasKhEnd) {
+    ok("<!-- knowledge-hub:start/end --> 块存在")
+  } else if (hasKhStart || hasKhEnd) {
+    fail("<!-- knowledge-hub --> 块不完整", `start=${hasKhStart} end=${hasKhEnd}，请重新运行 install.sh`)
+  } else {
+    fail("<!-- knowledge-hub:start/end --> 块缺失", "运行 install.sh 注入")
+  }
+
+  // 检测 teamkit-git markers
+  const hasGitStart = content.includes("<!-- teamkit-git:start -->")
+  const hasGitEnd = content.includes("<!-- teamkit-git:end -->")
+  if (hasGitStart && hasGitEnd) {
+    ok("<!-- teamkit-git:start/end --> 块存在")
+  } else if (hasGitStart || hasGitEnd) {
+    fail("<!-- teamkit-git --> 块不完整", `start=${hasGitStart} end=${hasGitEnd}，请重新运行 install.sh`)
+  } else {
+    fail("<!-- teamkit-git:start/end --> 块缺失", "运行 install.sh 注入")
+  }
+}
+
+// ─── 诊断 5：Git Agent 加载状态 ──────────────────────────────────────────────
+function diagGitAgent() {
+  section("Git Agent 加载状态")
+
+  const agentPath = join(PKG_ROOT, "agents", "teamkit-git.md")
+  if (!existsSync(agentPath)) {
+    fail("agents/teamkit-git.md 不存在")
+    return
+  }
+
+  let content
+  try {
+    content = readFileSync(agentPath, "utf8")
+  } catch (err) {
+    fail("agents/teamkit-git.md 读取失败", err.message)
+    return
+  }
+
+  ok("agents/teamkit-git.md 存在")
+
+  // 检测 hidden: true（限定多行匹配，防止内容区误匹配）
+  if (/^hidden:\s*true\s*$/m.test(content)) {
+    ok("hidden: true 已配置")
+  } else {
+    fail("hidden: true 缺失", "teamkit-git subagent 应设置 hidden: true")
+  }
+}
+
+// ─── 诊断 6：git-rules.json 合法性（全局 + 项目级） ─────────────────────────
+function diagGitRules() {
+  section("git-rules.json 合法性")
+
+  // 6a：全局配置
+  const globalRulesPath = join(HOME, ".config", "teamkit", "git-rules.json")
+  if (!existsSync(globalRulesPath)) {
+    warn("全局 git-rules.json 不存在", "~/.config/teamkit/git-rules.json — 将使用内置默认值（运行 install.sh 生成）")
+  } else {
+    let globalRules
+    try {
+      globalRules = JSON.parse(readFileSync(globalRulesPath, "utf8"))
+      ok(
+        "全局 git-rules.json 合法",
+        `messageStyle=${globalRules.messageStyle} language=${globalRules.messageLanguage}`,
+      )
+    } catch (err) {
+      fail("全局 git-rules.json JSON 解析失败", err.message)
+    }
+  }
+
+  // 6b：项目级配置
+  const rulesPath = join(process.cwd(), ".teamkit", "git-rules.json")
+  if (!existsSync(rulesPath)) {
+    warn(".teamkit/git-rules.json 不存在", "（可选）项目级未配置，将使用全局或内置默认值")
+    return
+  }
+
+  let rules
+  try {
+    rules = JSON.parse(readFileSync(rulesPath, "utf8"))
+  } catch (err) {
+    fail(".teamkit/git-rules.json JSON 解析失败", err.message)
+    return
+  }
+
+  // 检测必填字段（PRD §4.3 R11）
+  const required = ["branchPrefixes", "messageStyle", "messageLanguage", "maxFilesPerCommit", "lfsThresholdMB"]
+  const missing = required.filter((k) => rules[k] === undefined)
+
+  if (missing.length === 0) {
+    ok(".teamkit/git-rules.json 合法", `messageStyle=${rules.messageStyle} language=${rules.messageLanguage}`)
+  } else {
+    fail(".teamkit/git-rules.json 缺少必填字段", missing.join(", "))
+  }
+}
+
+// ─── 诊断 7：KH 静默失效诊断 ─────────────────────────────────────────────────
+// R15 增强（PRD §4.5 R15）：诊断 CodeForge 升级后 KH 静默失效
+function diagKhSilentFailure() {
+  section("KH 静默失效诊断")
+
+  if (!existsSync(OPENCODE_JSON_PATH)) {
+    warn("opencode.json 不存在，跳过静默失效检测")
+    return
+  }
+
+  let cfg
+  try {
+    cfg = JSON.parse(readFileSync(OPENCODE_JSON_PATH, "utf8"))
+  } catch {
+    warn("opencode.json 读取失败，跳过静默失效检测")
+    return
+  }
+
+  const plugins = cfg?.plugins ?? []
+  const pluginNames = plugins.map((p) => (typeof p === "string" ? p : p?.name ?? ""))
+
+  const hasCodeforge = pluginNames.some((n) => n.includes("codeforge"))
+  const hasTeamkit = pluginNames.some((n) => n.includes("teamkit"))
+
+  if (hasCodeforge && !hasTeamkit) {
+    // R15 增强：CodeForge 存在但 teamkit 未安装
+    warn(
+      "检测到 CodeForge 但未安装 @andyqiu/teamkit，KH 集成将静默失效。",
+      "运行：npm i -g @andyqiu/teamkit"
+    )
+  } else if (hasTeamkit) {
+    ok("@andyqiu/teamkit 已注册到 opencode.json plugins")
+    // 检查 teamkit 是否排在首位
+    const teamkitIdx = pluginNames.findIndex((n) => n.includes("teamkit"))
+    const codeforgeIdx = pluginNames.findIndex((n) => n.includes("codeforge"))
+    if (codeforgeIdx !== -1 && teamkitIdx > codeforgeIdx) {
+      warn("@andyqiu/teamkit 应排在 plugins 数组首位（当前在 codeforge 之后）", "运行 install.sh 修复顺序")
+    } else {
+      ok("plugin load order 正确（teamkit 在 codeforge 之前）")
+    }
+  } else {
+    warn("opencode.json plugins 中未找到 @andyqiu/teamkit", "运行 install.sh 注册")
+  }
+}
+
+// ─── 主流程 ───────────────────────────────────────────────────────────────────
+async function main() {
+  process.stdout.write("╔══════════════════════════════════════╗\n")
+  process.stdout.write("║     teamkit doctor — 系统诊断        ║\n")
+  process.stdout.write("╚══════════════════════════════════════╝\n")
+
+  diagOpenCodeVersion()
+  diagSessionCompacting()
+  await diagKhMcp()
+  diagAgentsMdMarkers()
+  diagGitAgent()
+  diagGitRules()
+  diagKhSilentFailure()
+
+  process.stdout.write("\n诊断完成。如有 ❌ 项，请按提示修复后重新运行。\n")
+  process.stdout.write("如需详细帮助：https://github.com/andyqiu/teamkit\n\n")
+}
+
+main().catch((err) => {
+  process.stderr.write(`teamkit doctor 内部错误: ${err.message}\n`)
+  process.exit(1)
+})

package/bin/teamkit-upgrade.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * bin/teamkit-upgrade.mjs — teamkit upgrade 命令
+ *
+ * 流程：
+ *   1. 读取当前版本（package.json）
+ *   2. 用 npm view @andyqiu/teamkit version 查询最新版本（超时 10s）
+ *   3. 若已是最新：提示并退出
+ *   4. 若有新版：显示 "当前 vX.X.X → 最新 vY.Y.Y，确认升级？[Y/n]"
+ *   5. 用户确认后：执行 npm install -g @andyqiu/teamkit@latest
+ *   6. 升级成功后：提示运行 teamkit install 以重新注入 AGENTS.md 配置
+ */
+import { createRequire } from 'node:module'
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { execFileSync, spawnSync } from 'node:child_process'
+import * as readline from 'node:readline'
+import process from 'node:process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+
+const currentVersion = pkg.version
+const pkgName = pkg.name // '@andyqiu/teamkit'
+
+function compareSemver(a, b) {
+  const pa = a.split('.').map(Number)
+  const pb = b.split('.').map(Number)
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return 1
+    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return -1
+  }
+  return 0
+}
+
+// ── 1. 查询最新版本 ────────────────────────────────────────────────────────────
+
+let latestVersion
+try {
+  latestVersion = execFileSync('npm', ['view', pkgName, 'version'], {
+    timeout: 10000,
+    encoding: 'utf8'
+  }).trim()
+} catch (err) {
+  console.error(`teamkit: 无法查询最新版本（网络问题或 npm registry 不可用）`)
+  console.error(`请手动升级：npm install -g ${pkgName}@latest`)
+  process.exit(1)
+}
+
+// ── 2. 比较版本 ───────────────────────────────────────────────────────────────
+
+if (compareSemver(currentVersion, latestVersion) >= 0) {
+  console.log(`✅ 已是最新版本 v${currentVersion}，无需升级。`)
+  process.exit(0)
+}
+
+// ── 3. 交互确认 ───────────────────────────────────────────────────────────────
+
+console.log(`发现新版本：当前 v${currentVersion} → 最新 v${latestVersion}`)
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+})
+
+rl.question('确认升级？[Y/n] ', (answer) => {
+  rl.close()
+
+  const confirmed = answer.trim() === '' || /^y(es)?$/i.test(answer.trim())
+  if (!confirmed) {
+    console.log('已取消升级。')
+    process.exit(0)
+  }
+
+  // ── 4. 执行升级 ─────────────────────────────────────────────────────────────
+
+  console.log(`正在升级 ${pkgName}@latest ...`)
+  const result = spawnSync('npm', ['install', '-g', `${pkgName}@latest`], {
+    stdio: 'inherit'
+  })
+
+  if (result.status !== 0) {
+    console.error(`teamkit: 升级失败（npm exit code: ${result.status}）`)
+    console.error(`请手动运行：npm install -g ${pkgName}@latest`)
+    process.exit(result.status ?? 1)
+  }
+
+  // ── 5. 升级后提示 ────────────────────────────────────────────────────────────
+
+  console.log(`✅ 升级完成！建议重新运行 teamkit install 以更新 AGENTS.md 配置。`)
+  process.exit(0)
+})

package/bin/teamkit.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+/**
+ * bin/teamkit.mjs — teamkit CLI 主入口
+ *
+ * 用法：
+ *   teamkit version / -v / --version   显示版本
+ *   teamkit doctor                      运行系统诊断
+ *   teamkit install [--dry-run]         安装/重新安装 teamkit 到 opencode
+ *   teamkit uninstall                   卸载 teamkit
+ *   teamkit upgrade                     升级到最新版本
+ *   teamkit help / -h / --help          显示帮助
+ */
+import { createRequire } from 'node:module'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import process from 'node:process'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+
+/** spawnSync 结果统一退出处理，避免 null status 被当成成功 */
+function exitFromSpawn(result) {
+  if (result.error) {
+    console.error(`teamkit: 子命令启动失败：${result.error.message}`)
+    process.exit(1)
+  }
+  if (result.status !== null) process.exit(result.status)
+  process.exit(1)
+}
+
+const args = process.argv.slice(2)
+const cmd = args[0]
+
+// ── help ─────────────────────────────────────────────────────────────────────
+
+if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+  console.log(`
+teamkit — AI 原生团队协作底座 v${pkg.version}
+
+用法：
+  teamkit -v / --version / version   显示版本
+  teamkit doctor                      运行系统诊断
+  teamkit install [--dry-run]         安装/重新安装 teamkit 到 opencode
+  teamkit uninstall                   卸载 teamkit
+  teamkit upgrade                     升级到最新版本
+  teamkit help                        显示本帮助
+`)
+  process.exit(0)
+}
+
+// ── version ───────────────────────────────────────────────────────────────────
+
+if (cmd === 'version' || cmd === '--version' || cmd === '-v') {
+  console.log(`@andyqiu/teamkit v${pkg.version}`)
+  process.exit(0)
+}
+
+// ── doctor ────────────────────────────────────────────────────────────────────
+
+if (cmd === 'doctor') {
+  const doctorPath = resolve(__dirname, 'teamkit-doctor.mjs')
+  const result = spawnSync(process.execPath, [doctorPath, ...args.slice(1)], {
+    stdio: 'inherit'
+  })
+  exitFromSpawn(result)
+}
+
+// ── install ───────────────────────────────────────────────────────────────────
+
+if (cmd === 'install') {
+  const installSh = resolve(__dirname, '..', 'install.sh')
+  if (!existsSync(installSh)) {
+    console.error(`teamkit: install.sh 未找到（期望路径：${installSh}）`)
+    process.exit(1)
+  }
+  const extraArgs = args.slice(1)
+  const result = spawnSync('bash', [installSh, ...extraArgs], {
+    stdio: 'inherit'
+  })
+  exitFromSpawn(result)
+}
+
+// ── uninstall ─────────────────────────────────────────────────────────────────
+
+if (cmd === 'uninstall') {
+  const installSh = resolve(__dirname, '..', 'install.sh')
+  if (!existsSync(installSh)) {
+    console.error(`teamkit: install.sh 未找到（期望路径：${installSh}）`)
+    console.error('请手动运行：bash <teamkit-pkg-root>/install.sh --uninstall')
+    process.exit(1)
+  }
+  const result = spawnSync('bash', [installSh, '--uninstall', ...args.slice(1)], {
+    stdio: 'inherit'
+  })
+  exitFromSpawn(result)
+}
+
+// ── upgrade ───────────────────────────────────────────────────────────────────
+
+if (cmd === 'upgrade') {
+  const upgradePath = resolve(__dirname, 'teamkit-upgrade.mjs')
+  const result = spawnSync(process.execPath, [upgradePath, ...args.slice(1)], {
+    stdio: 'inherit'
+  })
+  exitFromSpawn(result)
+}
+
+// ── unknown ───────────────────────────────────────────────────────────────────
+
+console.error(`teamkit: 未知命令 "${cmd}"`)
+console.error('运行 teamkit help 查看可用命令')
+process.exit(1)