@cregis-dev/cckit

Claude Code 企业级配置工具 — 编排外部工具，一条命令为团队统一 Rules、Skills、MCP、API 网关和 AI 开发方法论。

它解决什么问题

企业采用 Claude Code 时面临的核心痛点：

• 配置碎片化 — 每个项目、每个开发者各自为政，编码规范、安全策略、工具链配置不一致
• 最佳实践缺失 — AI 辅助开发需要精心设计的 Rules、Skills、Agents 才能发挥最大效能
• 重复劳动 — 新项目需要从零配置 MCP、方法论框架、编码规范
• API 管理分散 — 每个开发者自行配置 API 网关和模型，无法统一管控

cckit 将业界验证的 AI 开发最佳实践打包到一个 CLI 中：

| 能力 | 说明 | |------|------| | API 网关 | 统一配置企业 API 网关 URL、密钥和大模型（MiniMax、Kimi、Gemini、GPT） | | Rules | 来自 ECC 的企业级编码规范 — 覆盖 TypeScript、Python、Go，含安全、测试、性能、Git 工作流 | | Skills | 44+ 内置技能 + 第三方技能 — TDD、安全审计、前后端模式、数据库优化、API 设计、持续学习等 | | Methodology | 来自 BMAD 的 AI 驱动敏捷方法论 — 核心 Agent、测试架构、需求管理 | | MCP | 预配置的 Model Context Protocol 服务器 — 文档查询、浏览器自动化、Cloudflare 集成 | | Plugins | 7 个默认插件 — ECC、Superpowers、代码简化、提交工作流、CLAUDE.md 管理等 |

cckit 是编排工具，不是模板打包器。运行时调用外部工具（npx、git clone），不预置模板文件。

快速开始

# 直接使用（推荐）
npx @cregis-dev/cckit install

# 或全局安装
npm install -g @cregis-dev/cckit
cckit install

交互式引导会依次：

1. 配置 API 网关（默认 gateway.cregis.ai）和 API Key
2. 选择大模型（MiniMax / Kimi / Gemini / GPT）
3. 安装 Plugins、Rules、Skills、BMAD、MCP

本地测试

node bin/cckit.js install

企业统一部署

# 全默认模式 — 适合 CI/CD 或批量初始化
npx @cregis-dev/cckit install --yes --api-key sk-your-key

# 企业标准化参数
cckit install \
  --user-name "TeamMember" \
  --lang ts,py \
  --model kimi \
  --api-key sk-your-key \
  --communication-language English \
  --doc-language English \
  --yes

命令

cckit install

初始化项目，编排安装所有组件。

| 参数 | 简写 | 默认值 | 说明 | |------|------|--------|------| | --yes | -y | false | 接受所有默认值 | | --dir <path> | -d | 当前目录 | 目标项目目录 | | --user-name <name> | — | "User" | 你的名字 | | --lang <codes> | -l | ts,py,go | 编程语言（逗号分隔） | | --communication-language | — | "Chinese" | Agent 沟通语言 | | --doc-language | — | "Chinese" | 文档输出语言 | | --api-url <url> | — | gateway.cregis.ai | API 网关地址 | | --api-key <key> | — | — | API 密钥（未提供则交互式输入） | | --force-api-key | — | false | 强制覆盖已有 API Key | | --model <name> | — | minimax | 大模型：minimax / kimi / gemini / gpt | | --plugins <ids> | — | "default" | 插件 ID、"default" 或 "none" | | --no-bmad | — | — | 跳过 BMAD 安装 | | --no-ecc | — | — | 跳过 ECC Rules | | --no-mcp | — | — | 跳过 MCP 配置 | | --no-skills | — | — | 跳过 Skills 安装 | | --no-plugins | — | — | 跳过插件启用 | | --debug | — | false | 调试输出 |

cckit status

查看当前安装状态和各步骤执行结果。

cckit status
cckit status -d /path/to/project

cckit update

重新执行所有安装步骤，更新组件到最新版。

cckit update            # 重新执行所有步骤
cckit update --dry-run  # 仅预览，不修改
cckit update --no-apply # 仅检查，更新时间戳
cckit update --force    # 强制覆盖已修改的文件
cckit update --model gpt --api-key sk-new  # 更新模型和密钥

安装内容

编排步骤

| 步骤 | 工具 | 目标 | |------|------|------| | Configure User | 写入 ~/.claude/settings.json | API URL + API Key + 模型环境变量（用户级） | | Enable Plugins | 写入 .claude/settings.json | 插件 + 市场源 + 环境变量默认值（项目级） | | Install BMAD | npx bmad-method install | _bmad/core、_bmad/bmm、_bmad/tea、.claude/commands/ | | Install Rules | git clone + copy | .claude/rules/（ECC 编码规范） | | Install Skills | npx skills add | 从注册的技能仓库安装 | | Install MCP | 文件复制 | .mcp.json（MCP 服务器配置） |

用户级设置（~/.claude/settings.json）

| 环境变量 | 说明 | |----------|------| | ANTHROPIC_BASE_URL | API 网关地址（默认 https://gateway.cregis.ai） | | ANTHROPIC_AUTH_TOKEN | API 密钥 | | ANTHROPIC_MODEL | 默认模型 | | ANTHROPIC_SMALL_FAST_MODEL | 快速模型 | | ANTHROPIC_DEFAULT_SONNET_MODEL | Sonnet 映射 | | ANTHROPIC_DEFAULT_OPUS_MODEL | Opus 映射 | | ANTHROPIC_DEFAULT_HAIKU_MODEL | Haiku 映射 |

支持的模型：

| 别名 | 模型 ID | |------|---------| | minimax（默认） | MiniMax-M2.5 | | kimi | Kimi-K2.5 | | gemini | gemini-3.1-pro-preview | | gpt | gpt-5.3-codex |

项目级设置（.claude/settings.json）

默认写入的环境变量：

| 变量 | 值 | 说明 | |------|-----|------| | DISABLE_BUG_COMMAND | 1 | 禁用 /bug 命令 | | DISABLE_ERROR_REPORTING | 1 | 禁用 Sentry 错误报告 | | DISABLE_TELEMETRY | 1 | 禁用 Statsig 遥测 | | MCP_TIMEOUT | 60000 | MCP 工具超时（毫秒） | | MAX_THINKING_TOKENS | 31999 | 扩展思考最大 token 数 | | CLAUDE_CODE_MAX_OUTPUT_TOKENS | 64000 | 输出最大 token 数 |

插件体系

cckit 默认启用 7 个 Claude Code marketplace 插件，写入 .claude/settings.json 的 enabledPlugins：

• everything-claude-code — 全套 ECC Skills/Agents/Commands
• superpowers — 结构化开发工作流
• claude-code-setup — 自动化分析与 CLAUDE.md 审计
• claude-md-management — CLAUDE.md 改进工具
• code-simplifier — 代码简化 Agent
• commit-commands — Git 提交工作流
• firecrawl — 网页爬取与搜索

生成的目录结构

your-project/
├── _bmad/                       # BMAD 方法论框架
│   ├── core/                    #   核心 Agent 与 Task 定义
│   ├── bmm/                     #   敏捷方法工作流
│   ├── tea/                     #   测试架构企业版
│   └── _config/                 #   配置 + manifest.yaml
├── _bmad-output/                # BMAD 产出物（自动创建）
│   ├── planning-artifacts/
│   ├── implementation-artifacts/
│   └── test-artifacts/
├── .claude/                     # Claude Code 配置
│   ├── rules/                   #   ECC 编码规范（按语言分目录）
│   ├── commands/                #   BMAD 命令
│   └── settings.json            #   插件 + 市场源 + 环境变量
├── .mcp.json                    # Claude Code MCP 配置
└── docs/                        # 项目文档目录

上游来源

| 来源 | 类型 | 项目 | |------|------|------| | BMAD | npm (运行时) | bmad-method | | ECC | Git clone (运行时) | everything-claude-code | | Skills | npm (运行时) | 按 registry.json 中配置的仓库 |

系统要求

• Node.js >= 18.0.0
• git（ECC Rules 克隆需要）

开发

详见 CONTRIBUTING.md。

npm install
npm test

许可证

MIT