teamkit

面向整个项目组的 OpenCode 共享插件——AI 原生团队协作底座。

teamkit 让程序员、策划、美术等任意角色，安装后让 AI 自动获得两大能力：团队知识库（KH）深度集成和Git 安全协作。

安装

npm install -g @andyqiu/teamkit

postinstall 自动完成全局配置，装完重启 opencode 即生效。

安装完成后，opencode 每次启动时会自动检测并升级到最新版本，无需手动维护。

能力

KH 集成：AI 自动带着团队记忆工作——遇到"以前 / 为什么 / 怎么部署"等触发词时召回知识库； 新会话自动注入相关上下文；长对话不会"忘事"；修完 bug / 做完决策自动沉淀回知识库，全团队共享。

Git 安全协作：对 AI 说"提交一下"，它会自动接管全流程——采集现状、生成提交说明、让你确认再 执行。提交前自动检测敏感信息、大文件、误操作主分支等风险并拦截。

命令

teamkit install               # 安装到 opencode 全局配置（首次必跑）
teamkit upgrade               # 手动升级到 npm 最新版（opencode 启动时也会自动升级）
teamkit doctor                # 系统诊断（KH MCP / plugin / Git Agent / git-rules.json 状态）
teamkit list                  # 探测 opencode 是否在机器上
teamkit rollback [--to=X.Y.Z] # 回滚到指定版本（例：teamkit rollback --to=0.5.18）
teamkit version               # 打印当前版本
teamkit uninstall             # 卸载提示
teamkit help [<cmd>]          # 查看帮助

项目级配置（.teamkit/git-rules.json）

teamkit-git 会读取当前仓库根目录的 .teamkit/git-rules.json，以下为一份示例配置：

{
  "branchPrefixes": ["feat/", "fix/", "docs/", "art/", "design/", "refactor/", "chore/"],
  "messageStyle": "conventional",
  "messageLanguage": "auto",
  "maxFilesPerCommit": 20,
  "lfsThresholdMB": 10,
  "sensitivePatterns": []
}

• messageStyle: "conventional"（程序员规范，含 feat: 前缀）或 "narrative"（叙述式，策划/美术适用）
• messageLanguage: "zh" / "en" / "auto"
• lfsThresholdMB: 大文件阈值，超过则警告并推荐 git LFS

License

MIT © Andy