@cregis-dev/cckit 0.4.1 → 0.6.1

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@cregis-dev/cckit.svg)](https://www.npmjs.com/package/@cregis-dev/cckit)
 [![license](https://img.shields.io/npm/l/@cregis-dev/cckit.svg)](LICENSE)
 
-Claude Code 企业级配置标准 — 一条命令为团队统一 Rules、Skills、MCP 和 AI 开发方法论。
+Claude Code 企业级配置工具 — 编排外部工具，一条命令为团队统一 Rules、Skills、MCP、API 网关和 AI 开发方法论。
 
 ## 它解决什么问题
 
@@ -12,18 +12,20 @@ Claude Code 企业级配置标准 — 一条命令为团队统一 Rules、Skills
 - **配置碎片化** — 每个项目、每个开发者各自为政，编码规范、安全策略、工具链配置不一致
 - **最佳实践缺失** — AI 辅助开发需要精心设计的 Rules、Skills、Agents 才能发挥最大效能
 - **重复劳动** — 新项目需要从零配置 MCP、方法论框架、编码规范
+- **API 管理分散** — 每个开发者自行配置 API 网关和模型，无法统一管控
 
 cckit 将业界验证的 AI 开发最佳实践打包到一个 CLI 中：
 
 | 能力 | 说明 |
 |------|------|
-| **Rules** | 来自 [ECC](https://github.com/affaan-m/everything-claude-code) 的企业级编码规范 — 覆盖 TypeScript、Python、Go、Swift，含安全、测试、性能、Git 工作流 |
+| **API 网关** | 统一配置企业 API 网关 URL、密钥和大模型（MiniMax、Kimi、Gemini、GPT） |
+| **Rules** | 来自 [ECC](https://github.com/affaan-m/everything-claude-code) 的企业级编码规范 — 覆盖 TypeScript、Python、Go，含安全、测试、性能、Git 工作流 |
 | **Skills** | 44+ 内置技能 + 第三方技能 — TDD、安全审计、前后端模式、数据库优化、API 设计、持续学习等 |
 | **Methodology** | 来自 [BMAD](https://www.npmjs.com/package/bmad-method) 的 AI 驱动敏捷方法论 — 核心 Agent、测试架构、需求管理 |
 | **MCP** | 预配置的 Model Context Protocol 服务器 — 文档查询、浏览器自动化、Cloudflare 集成 |
 | **Plugins** | 7 个默认插件 — ECC、Superpowers、代码简化、提交工作流、CLAUDE.md 管理等 |
 
-模板已内嵌在 npm 包中，`cckit init` **无需网络请求**。
+cckit 是**编排工具**，不是模板打包器。运行时调用外部工具（npx、git clone），不预置模板文件。
 
 ## 快速开始
 
@@ -36,37 +38,34 @@ npm install -g @cregis-dev/cckit
 cckit init
 ```
 
-交互式引导会依次询问：
+交互式引导会依次：
 
-1. 你的名字（Agent 会用这个称呼你）
-2. 沟通语言 / 文档输出语言
-3. 项目使用的编程语言（TypeScript / Python / Go）
-4. 安装哪些模块
+1. 配置 API 网关（默认 `gateway.cregis.ai`）和 API Key
+2. 选择大模型（MiniMax / Kimi / Gemini / GPT）
+3. 安装 Plugins、Rules、Skills、BMAD、MCP
 
 ### 企业统一部署
 
-在所有项目中使用相同配置：
-
 ```bash
 # 全默认模式 — 适合 CI/CD 或批量初始化
-npx @cregis-dev/cckit init --yes
+npx @cregis-dev/cckit init --yes --api-key sk-your-key
 
 # 企业标准化参数
 cckit init \
   --user-name "TeamMember" \
   --lang ts,py \
+  --model kimi \
+  --api-key sk-your-key \
   --communication-language English \
   --doc-language English \
   --yes
 ```
 
-> **Trae IDE**：cckit 同时支持 Trae 配置输出。添加 `--ides claude-code,trae` 参数即可启用。
-
 ## 命令
 
 ### `cckit init`
 
-初始化项目，安装企业级配置模板。
+初始化项目，编排安装所有组件。
 
 | 参数 | 简写 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -74,21 +73,23 @@ cckit init \
 | `--dir <path>` | `-d` | 当前目录 | 目标项目目录 |
 | `--user-name <name>` | — | `"User"` | 你的名字 |
 | `--lang <codes>` | `-l` | `ts,py,go` | 编程语言（逗号分隔） |
-| `--modules <ids>` | `-m` | `"all"` | 模块 ID 或 `"all"` |
-| `--ides <ids>` | — | `claude-code,trae` | 目标 IDE |
-| `--no-bmad` | — | — | 跳过 BMAD 模块 |
-| `--no-ecc` | — | — | 跳过 ECC 模块 |
-| `--no-trae` | — | — | 跳过 Trae 配置 |
-| `--no-mcp` | — | — | 跳过 MCP 配置 |
+| `--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-plugins` | — | — | 跳过插件安装 |
-| `--communication-language` | — | `"汉语"` | Agent 沟通语言 |
-| `--doc-language` | — | `"汉语"` | 文档输出语言 |
+| `--no-bmad` | — | — | 跳过 BMAD 安装 |
+| `--no-ecc` | — | — | 跳过 ECC Rules |
+| `--no-mcp` | — | — | 跳过 MCP 配置 |
+| `--no-skills` | — | — | 跳过 Skills 安装 |
+| `--no-plugins` | — | — | 跳过插件启用 |
 | `--debug` | — | `false` | 调试输出 |
 
 ### `cckit status`
 
-查看当前安装状态、模块列表和文件统计。
+查看当前安装状态和各步骤执行结果。
 
 ```bash
 cckit status
@@ -97,44 +98,53 @@ cckit status -d /path/to/project
 
 ### `cckit update`
 
-检查已安装文件变更状态并更新。默认行为是重新安装 + 发现新文件。
+重新执行所有安装步骤，更新组件到最新版。
 
 ```bash
-cckit update            # 检查并更新（默认 --apply）
+cckit update            # 重新执行所有步骤
 cckit update --dry-run  # 仅预览，不修改
-cckit update --no-apply # 仅检查，不更新
-cckit update --force    # 强制覆盖已修改的文件（不备份）
-```
-
-更新策略：
-- **unchanged** — 从模板重新安装（刷新到最新版）
-- **modified** — 备份为 `.bak.<timestamp>` 后重新安装（`--force` 跳过备份）
-- **missing** — 从模板恢复
-- **new** — 模板中新增但尚未安装的文件自动发现并安装
-
-### `cckit add <github-url>`
-
-安装第三方插件。插件仓库须含 `cckit-plugin.json`。
-
-```bash
-cckit add https://github.com/user/my-plugin
+cckit update --no-apply # 仅检查，更新时间戳
+cckit update --force    # 强制覆盖已修改的文件
+cckit update --model gpt --api-key sk-new  # 更新模型和密钥
 ```
 
 ## 安装内容
 
-### Claude Code 配置
+### 编排步骤
 
-| 内容 | 模块 | 目标路径 |
-|------|------|---------|
-| BMAD 基础设施 | bmad-core/bmm/tea/config | `_bmad/*` |
-| BMAD 命令 | bmad-commands | `.claude/commands/` |
-| ECC Rules | ecc-rules | `.claude/rules/` |
-| 独立 Skills | ext-skills | `.claude/skills/` |
-| MCP 配置 | mcp | `.mcp.json` |
-| 插件 ID + 市场源 | plugins | `.claude/settings.json` |
-| 环境变量默认值 | — (始终写入) | `.claude/settings.json` |
+| 步骤 | 工具 | 目标 |
+|------|------|------|
+| **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` |
 
-默认写入的环境变量（`settings.json` → `env`）：
+### 项目级设置（`.claude/settings.json`）
+
+默认写入的环境变量：
 
 | 变量 | 值 | 说明 |
 |------|-----|------|
@@ -147,7 +157,7 @@ cckit add https://github.com/user/my-plugin
 
 ### 插件体系
 
-cckit 默认启用 7 个 Claude Code marketplace 插件，写入 `.claude/settings.json` 的 `enabledPlugins`。用户信任项目后 Claude Code 自动提示安装：
+cckit 默认启用 7 个 Claude Code marketplace 插件，写入 `.claude/settings.json` 的 `enabledPlugins`：
 
 - **everything-claude-code** — 全套 ECC Skills/Agents/Commands
 - **superpowers** — 结构化开发工作流
@@ -157,35 +167,6 @@ cckit 默认启用 7 个 Claude Code marketplace 插件，写入 `.claude/settin
 - **commit-commands** — Git 提交工作流
 - **firecrawl** — 网页爬取与搜索
 
-### Trae 配置（可选）
-
-启用 `--ides claude-code,trae` 后额外生成：
-
-| 内容 | 目标路径 |
-|------|---------|
-| BMAD Rules | `.trae/rules/bmad-*.md` |
-| ECC Rules/Agents/Commands | `.trae/rules/ecc/` |
-| ECC Skills | `.trae/skills/<id>/SKILL.md` |
-| 独立 Skills | `.trae/skills/<id>/SKILL.md` |
-| 插件内容 | `.trae/skills/` + `.trae/rules/<pluginId>/` |
-| MCP 配置 | `.trae/mcp.json` |
-
-### 内置 Skills 一览
-
-| 领域 | Skills |
-|------|--------|
-| 开发流程 | `tdd-workflow`, `coding-standards`, `security-review`, `security-scan`, `eval-harness` |
-| 前端 | `frontend-patterns`, `e2e-testing` |
-| 后端 | `backend-patterns`, `api-design`, `postgres-patterns`, `clickhouse-io` |
-| Python | `python-patterns`, `python-testing`, `django-patterns`, `django-security`, `django-tdd` |
-| Go | `golang-patterns`, `golang-testing` |
-| Java/Spring | `springboot-patterns`, `springboot-security`, `springboot-tdd`, `jpa-patterns` |
-| C++/Swift | `cpp-coding-standards`, `cpp-testing`, `swift-actor-persistence`, `swift-protocol-di-testing` |
-| DevOps | `docker-patterns`, `deployment-patterns`, `database-migrations` |
-| AI 工具链 | `continuous-learning-v2`, `strategic-compact`, `iterative-retrieval` |
-
-完整列表见 `templates/ecc/skills/` 目录。
-
 ## 生成的目录结构
 
 ```
@@ -201,47 +182,24 @@ your-project/
 │   └── test-artifacts/
 ├── .claude/                     # Claude Code 配置
 │   ├── rules/                   #   ECC 编码规范（按语言分目录）
-│   ├── skills/                  #   独立第三方 Skills
 │   ├── commands/                #   BMAD 命令
 │   └── settings.json            #   插件 + 市场源 + 环境变量
 ├── .mcp.json                    # Claude Code MCP 配置
-├── .trae/                       # Trae IDE 配置（可选，需 --ides 指定）
-│   ├── rules/                   #   Rules + Agents + Commands
-│   ├── skills/                  #   Skills
-│   └── mcp.json
 └── docs/                        # 项目文档目录
 ```
 
-## 模块清单
-
-| ID | 名称 | 必装 | 默认 | 依赖 | 说明 |
-|----|------|:----:|:----:|------|------|
-| `bmad-core` | BMAD Core | ✓ | — | — | 核心框架 |
-| `bmad-bmm` | BMAD Method | — | ✓ | bmad-core | 敏捷方法 |
-| `bmad-tea` | Test Architecture | — | ✓ | bmad-core | 测试架构 |
-| `bmad-commands` | BMAD Commands | — | ✓ | bmad-core | Claude Code 命令 |
-| `bmad-config` | BMAD Config | — | ✓ | bmad-core | 框架配置 |
-| `bmad-trae` | BMAD Trae Rules | — | ✓ | bmad-core | Trae 规则（可选） |
-| `ecc-rules` | ECC Rules | — | ✓ | — | 编码规范 |
-| `ecc-agents` | ECC Agents | — | ✓ | — | Trae 专用 |
-| `ecc-skills` | ECC Skills | — | ✓ | — | Trae 专用 |
-| `ecc-commands` | ECC Commands | — | ✓ | — | Trae 专用 |
-| `ext-skills` | Third-party Skills | — | ✓ | — | 两个 IDE |
-| `mcp` | MCP Server Config | — | ✓ | — | 两个 IDE |
-
 ## 上游来源
 
 | 来源 | 类型 | 项目 |
 |------|------|------|
-| BMAD | npm | [bmad-method](https://www.npmjs.com/package/bmad-method) |
-| ECC | Git | [everything-claude-code](https://github.com/affaan-m/everything-claude-code) |
-| Ext-skills | Git | 独立 GitHub 仓库（按 skill 配置） |
-| Plugins | Git | [claude-plugins-official](https://github.com/anthropics/claude-plugins-official) |
+| BMAD | npm (运行时) | [bmad-method](https://www.npmjs.com/package/bmad-method) |
+| ECC | Git clone (运行时) | [everything-claude-code](https://github.com/affaan-m/everything-claude-code) |
+| Skills | npm (运行时) | 按 `registry.json` 中配置的仓库 |
 
 ## 系统要求
 
 - Node.js >= 18.0.0
-- git（`cckit add` 需要克隆 GitHub 仓库）
+- git（ECC Rules 克隆需要）
 
 ## 开发
 

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "@cregis-dev/cckit",
-  "version": "0.4.1",
-  "description": "Enterprise-grade Claude Code configuration toolkit — unified rules, skills, MCP and methodology for teams",
-  "type": "module",
-  "bin": {
-    "cckit": "./bin/cckit.js"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "templates/",
-    "registry.json"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "release": "node scripts/release.js",
-    "release:dry": "node scripts/release.js --dry-run"
-  },
-  "keywords": [
-    "claude-code",
-    "enterprise",
-    "configuration",
-    "bmad",
-    "ecc",
-    "mcp",
-    "cli",
-    "rules",
-    "ai-coding",
-    "developer-tools",
-    "team"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "fs-extra": "^11.3.3",
-    "glob": "^13.0.3",
-    "yaml": "^2.8.2"
-  },
-  "devDependencies": {
-    "@vitest/coverage-v8": "^4.0.18",
-    "execa": "^9.6.1",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "@cregis-dev/cckit",
+  "version": "0.6.1",
+  "description": "Enterprise-grade Claude Code configuration toolkit — orchestrates external tools to set up unified rules, skills, MCP and methodology for teams",
+  "type": "module",
+  "bin": {
+    "cckit": "./bin/cckit.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/mcp/",
+    "registry.json",
+    "templates/rules/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "release": "node scripts/release.js",
+    "release:dry": "node scripts/release.js --dry-run"
+  },
+  "keywords": [
+    "claude-code",
+    "enterprise",
+    "configuration",
+    "bmad",
+    "ecc",
+    "mcp",
+    "cli",
+    "rules",
+    "ai-coding",
+    "developer-tools",
+    "team"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.3",
+    "glob": "^13.0.3",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
+    "vitest": "^4.0.18"
+  }
+}