@cregis-dev/cckit 0.6.5 → 0.6.7

package/README.md

@@ -1,221 +1,221 @@
-# @cregis-dev/cckit
-
-[![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、API 网关和 AI 开发方法论。
-
-## 它解决什么问题
-
-企业采用 Claude Code 时面临的核心痛点：
-
-- **配置碎片化** — 每个项目、每个开发者各自为政，编码规范、安全策略、工具链配置不一致
-- **最佳实践缺失** — AI 辅助开发需要精心设计的 Rules、Skills、Agents 才能发挥最大效能
-- **重复劳动** — 新项目需要从零配置 MCP、方法论框架、编码规范
-- **API 管理分散** — 每个开发者自行配置 API 网关和模型，无法统一管控
-
-cckit 将业界验证的 AI 开发最佳实践打包到一个 CLI 中：
-
-| 能力 | 说明 |
-|------|------|
-| **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 管理等 |
-
-cckit 是**编排工具**，不是模板打包器。运行时调用外部工具（npx、git clone），不预置模板文件。
-
-## 快速开始
-
-```bash
-# 直接使用（推荐）
-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
-
-### 本地测试
-
-```bash
-node bin/cckit.js install
-```
-
-### 企业统一部署
-
-```bash
-# 全默认模式 — 适合 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`
-
-查看当前安装状态和各步骤执行结果。
-
-```bash
-cckit status
-cckit status -d /path/to/project
-```
-
-### `cckit update`
-
-重新执行所有安装步骤，更新组件到最新版。
-
-```bash
-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](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（ECC Rules 克隆需要）
-
-## 开发
-
-详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
-
-```bash
-npm install
-npm test
-```
-
-## 许可证
-
-[MIT](LICENSE)
+# @cregis-dev/cckit
+
+[![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、API 网关和 AI 开发方法论。
+
+## 它解决什么问题
+
+企业采用 Claude Code 时面临的核心痛点：
+
+- **配置碎片化** — 每个项目、每个开发者各自为政，编码规范、安全策略、工具链配置不一致
+- **最佳实践缺失** — AI 辅助开发需要精心设计的 Rules、Skills、Agents 才能发挥最大效能
+- **重复劳动** — 新项目需要从零配置 MCP、方法论框架、编码规范
+- **API 管理分散** — 每个开发者自行配置 API 网关和模型，无法统一管控
+
+cckit 将业界验证的 AI 开发最佳实践打包到一个 CLI 中：
+
+| 能力 | 说明 |
+|------|------|
+| **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 管理等 |
+
+cckit 是**编排工具**，不是模板打包器。运行时调用外部工具（npx、git clone），不预置模板文件。
+
+## 快速开始
+
+```bash
+# 直接使用（推荐）
+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
+
+### 本地测试
+
+```bash
+node bin/cckit.js install
+```
+
+### 企业统一部署
+
+```bash
+# 全默认模式 — 适合 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`
+
+查看当前安装状态和各步骤执行结果。
+
+```bash
+cckit status
+cckit status -d /path/to/project
+```
+
+### `cckit update`
+
+重新执行所有安装步骤，更新组件到最新版。
+
+```bash
+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](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（ECC Rules 克隆需要）
+
+## 开发
+
+详见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+```bash
+npm install
+npm test
+```
+
+## 许可证
+
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cregis-dev/cckit",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Enterprise-grade Claude Code configuration toolkit — orchestrates external tools to set up unified rules, skills, MCP and methodology for teams",
   "type": "module",
   "bin": {