@cregis-dev/cckit 0.4.0 → 0.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 cregis-dev
-
-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.
+MIT License
+
+Copyright (c) 2025 cregis-dev
+
+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

@@ -3,20 +3,29 @@
 [![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)
 
-多 IDE 项目一键配置工具 — 一条命令为 Claude Code 和 Trae 安装 BMAD + ECC + Skills + MCP 全部配置。
+Claude Code 企业级配置工具 — 编排外部工具，一条命令为团队统一 Rules、Skills、MCP、API 网关和 AI 开发方法论。
 
-## 它是什么
+## 它解决什么问题
 
-cckit 将四套 AI 辅助开发最佳实践打包到一个 CLI 中，为 **Claude Code** 和 **Trae** IDE 提供完整的开发环境配置：
+企业采用 Claude Code 时面临的核心痛点：
 
-| 类型 | 说明 |
+- **配置碎片化** — 每个项目、每个开发者各自为政，编码规范、安全策略、工具链配置不一致
+- **最佳实践缺失** — AI 辅助开发需要精心设计的 Rules、Skills、Agents 才能发挥最大效能
+- **重复劳动** — 新项目需要从零配置 MCP、方法论框架、编码规范
+- **API 管理分散** — 每个开发者自行配置 API 网关和模型，无法统一管控
+
+cckit 将业界验证的 AI 开发最佳实践打包到一个 CLI 中：
+
+| 能力 | 说明 |
 |------|------|
-| **BMAD** | 来自 [bmad-method](https://www.npmjs.com/package/bmad-method) 的 AI 驱动敏捷方法论框架，含核心配置、敏捷方法、测试架构 |
-| **ECC** | 来自 [everything-claude-code](https://github.com/affaan-m/everything-claude-code) 的 Rules / Agents / Commands / Skills 配置（Claude Code 仅分发 Rules，其余通过 marketplace 插件获取） |
-| **Skills** | 44 个内置技能 + 第三方技能 + 插件技能，覆盖 TDD、安全审计、前后端模式、多语言规范等（来源独立于 ECC） |
-| **MCP** | IDE 工具集成配置 — 为 Claude Code 和 Trae 配置 Model Context Protocol 服务器连接 |
+| **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），不预置模板文件。
 
 ## 快速开始
 
@@ -29,37 +38,34 @@ npm install -g @cregis-dev/cckit
 cckit init
 ```
 
-交互式引导会依次询问：
+交互式引导会依次：
 
-1. 你的名字（Agent 会用这个称呼你）
-2. 沟通语言 / 文档输出语言
-3. 配置哪些 IDE（Claude Code / Trae）
-4. 项目使用的编程语言（TypeScript / Python / Go）
-5. 安装哪些模块
+1. 配置 API 网关（默认 `gateway.cregis.ai`）和 API Key
+2. 选择大模型（MiniMax / Kimi / Gemini / GPT）
+3. 安装 Plugins、Rules、Skills、BMAD、MCP
 
-### 一键模式
+### 企业统一部署
 
 ```bash
-npx @cregis-dev/cckit init --yes
-```
-
-### 自定义模式
+# 全默认模式 — 适合 CI/CD 或批量初始化
+npx @cregis-dev/cckit init --yes --api-key sk-your-key
 
-```bash
+# 企业标准化参数
 cckit init \
-  --user-name "Alice" \
+  --user-name "TeamMember" \
   --lang ts,py \
-  --ides claude-code \
-  --no-trae \
+  --model kimi \
+  --api-key sk-your-key \
   --communication-language English \
-  --doc-language English
+  --doc-language English \
+  --yes
 ```
 
 ## 命令
 
 ### `cckit init`
 
-初始化项目，安装模板文件。
+初始化项目，编排安装所有组件。
 
 | 参数 | 简写 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -67,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
@@ -90,53 +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    # 强制覆盖已修改的文件（不备份）
+cckit update --no-apply # 仅检查，更新时间戳
+cckit update --force    # 强制覆盖已修改的文件
+cckit update --model gpt --api-key sk-new  # 更新模型和密钥
 ```
 
-更新策略：
-- **unchanged** — 从模板重新安装（刷新到最新版）
-- **modified** — 备份为 `.bak.<timestamp>` 后重新安装（`--force` 跳过备份）
-- **missing** — 从模板恢复
-- **new** — 模板中新增但尚未安装的文件自动发现并安装
-
-### `cckit add <github-url>`
-
-安装第三方插件。插件仓库须含 `cckit-plugin.json`，内容仅分发到 Trae（Claude Code 请通过 marketplace 安装插件）。
-
-```bash
-cckit add https://github.com/user/my-plugin
-```
-
-## 分发模型
-
-cckit 使用两套独立的分发体系：
-
-**插件体系**（ECC、Superpowers 等 marketplace 插件）：
-- **Claude Code** — 将插件 ID 写入 `.claude/settings.json`（`enabledPlugins`），非内置市场同时注册 `extraKnownMarketplaces`，用户信任项目后 Claude Code 自动提示安装；插件内容由 marketplace 获取
-- **Trae** — 提取 skills（直接复制）、commands/agents（通过 trae-adapter 添加 YAML frontmatter）
+## 安装内容
 
-**Skills 体系**（ext-skills 等独立第三方技能）：
-- **两个 IDE** — 直接复制到 `.claude/skills/` 和 `.trae/skills/`
+### 编排步骤
 
-### 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` |
-
-默认写入的环境变量（`settings.json` → `env`）：
+| 步骤 | 工具 | 目标 |
+|------|------|------|
+| **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`）
+
+默认写入的环境变量：
 
 | 变量 | 值 | 说明 |
 |------|-----|------|
@@ -147,52 +155,17 @@ cckit 使用两套独立的分发体系：
 | `MAX_THINKING_TOKENS` | `31999` | 扩展思考最大 token 数 |
 | `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | `64000` | 输出最大 token 数 |
 
-### Trae 安装内容（完整分发）
-
-| 内容 | 模块 | 目标路径 |
-|------|------|---------|
-| BMAD Rules | bmad-trae | `.trae/rules/bmad-*.md` |
-| ECC Rules | ecc-rules | `.trae/rules/ecc/{common,golang,...}/` |
-| ECC Agents | ecc-agents | `.trae/rules/ecc/agents/` |
-| ECC Commands | ecc-commands | `.trae/rules/ecc/commands/` |
-| ECC Skills | ecc-skills | `.trae/skills/<id>/SKILL.md` |
-| 独立 Skills | ext-skills | `.trae/skills/<id>/SKILL.md` |
-| 插件 Skills/Agents/Commands | plugins | `.trae/skills/` + `.trae/rules/<pluginId>/` |
-| MCP 配置 | mcp | `.trae/mcp.json` |
-
-### 内置 ECC 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/` 目录。`cckit init` 默认安装全部 ECC Skills。
+### 插件体系
 
-### 添加第三方 Skill
+cckit 默认启用 7 个 Claude Code marketplace 插件，写入 `.claude/settings.json` 的 `enabledPlugins`：
 
-通过 `cckit add` 安装包含 skills 的插件仓库（须含 `cckit-plugin.json`）：
-
-```bash
-cckit add https://github.com/user/my-plugin
-```
-
-插件 manifest 示例：
-
-```json
-{
-  "name": "my-plugin",
-  "version": "1.0.0",
-  "contents": { "skills": "skills/" }
-}
-```
+- **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** — 网页爬取与搜索
 
 ## 生成的目录结构
 
@@ -209,47 +182,24 @@ your-project/
 │   └── test-artifacts/
 ├── .claude/                     # Claude Code 配置
 │   ├── rules/                   #   ECC 编码规范（按语言分目录）
-│   ├── skills/                  #   独立第三方 Skills（ext-skills）
 │   ├── commands/                #   BMAD 命令
-│   └── settings.json            #   插件配置 + 市场源 + 环境变量默认值
-├── .trae/                       # Trae IDE 配置（如启用）
-│   ├── rules/                   #   BMAD Rules + ECC Rules/Agents/Commands + 插件
-│   ├── skills/                  #   ECC Skills + 独立 Skills + 插件 Skills
-│   └── mcp.json
+│   └── settings.json            #   插件 + 市场源 + 环境变量
 ├── .mcp.json                    # Claude Code MCP 配置
 └── docs/                        # 项目文档目录
 ```
 
-## 模块清单
-
-| ID | 名称 | 必装 | 默认 | 依赖 | IDE 限定 |
-|----|------|:----:|:----:|------|----------|
-| `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 | — | ✓ | — | 全部 |
-| `mcp` | MCP Server Config | — | ✓ | — | 全部 |
-
 ## 上游来源
 
 | 来源 | 类型 | 项目 |
 |------|------|------|
-| 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/bin/cckit.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-import { run } from '../src/cli.js'
-run(process.argv)
+#!/usr/bin/env node
+import { run } from '../src/cli.js'
+run(process.argv)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cregis-dev/cckit",
-  "version": "0.4.0",
-  "description": "Multi-IDE AI dev environment setup CLI — BMAD + ECC + Skills + MCP for Claude Code and Trae",
+  "version": "0.5.0",
+  "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"
@@ -12,7 +12,7 @@
   "files": [
     "bin/",
     "src/",
-    "templates/",
+    "templates/mcp/",
     "registry.json"
   ],
   "engines": {
@@ -27,14 +27,16 @@
   },
   "keywords": [
     "claude-code",
-    "trae",
+    "enterprise",
+    "configuration",
     "bmad",
     "ecc",
     "mcp",
     "cli",
-    "project-setup",
+    "rules",
     "ai-coding",
-    "developer-tools"
+    "developer-tools",
+    "team"
   ],
   "license": "MIT",
   "dependencies": {
@@ -46,7 +48,6 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",
-    "execa": "^9.6.1",
     "vitest": "^4.0.18"
   }
 }