# cc-tools **Repository Path**: zzsvip/cc-tools ## Basic Information - **Project Name**: cc-tools - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-14 - **Last Updated**: 2026-05-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # cc-tools [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Version](https://img.shields.io/badge/version-0.3.6-blue.svg)](CHANGELOG.md) [![cc](https://img.shields.io/badge/Claude%20Code-plugin-purple.svg)](https://docs.claude.com/claude-code) [![Lang](https://img.shields.io/badge/lang-中文-red.svg)](README.md) 为**资深 Java 工程师**打造的 Claude Code 插件，覆盖大型分布式微服务系统从立项到验收的全生命周期。 **设计目标**：可演进、可切换、可扩展。默认追求"**一套代码，两种部署**"——单体起步，平滑切换到分布式。 > 📦 仓库地址：`https://gitee.com/zzsvip/cc-tools.git` ## 快速链接 - 📖 [5 分钟快速开始](docs/quickstart.md) - 🚶 [**完整操作示例**：从 0 搭建分布式订单系统](docs/walkthrough.md) ⭐ 推荐先看 - 🗺️ [**插件结构索引**：命令/Agent/Skill 调用关系](INDEX.md) ⭐ 维护者必读 - 🛠️ [定制指南](docs/customization.md) - 🩹 [故障排查 FAQ](docs/troubleshooting.md) - 🤝 [贡献指南](CONTRIBUTING.md) - 📜 [版本变更](CHANGELOG.md) ## 适用场景 - Java 后端团队（**Spring Boot / WebFlux**，按项目选范式） - 前端 Vue3 + TypeScript（AI 主导生成） - 数据库 MySQL / PostgreSQL - 多业务领域可复用：业务系统、物联网平台、后台管理、AI 服务等 - 多端配套：APP / 小程序（前端层按需扩展） ## 架构风格按业务选 ``` 第 1 步：架构驱动力分析 → 第 2 步：风格选择 （规模/一致性/演进/合规…） 建模 MVC ｜ DDD 编程 命令式 ｜ 响应式 部署 单体 ｜ 模块化单体 ｜ 单体可切换 ｜ 微服务 交互 同步 ｜ 事件驱动 ``` `/design` 先做架构驱动力分析，再据此选风格——不套模板。"单体可切换"是推荐默认，但要被驱动力验证。 ## 安装 详见 [docs/quickstart.md](docs/quickstart.md)。三步速览： ```bash # 1. 克隆 git clone https://gitee.com/zzsvip/cc-tools.git # 2. 软链到 cc 插件目录（Linux/Mac） ln -s "$(pwd)/cc-tools" ~/.claude/plugins/cc-tools # 3. 重启 cc，验证 # 在 cc 中输入：/help # 应看到 13 个命令：/plan /review /kickoff /ship # /design /design-overview /design-detail /scaffold # /build-fix /quality-gate /refactor-clean /update-docs /update-codemaps ``` ## 命令一览（13） 按"频率"分组： ### 一次性命令（每个项目跑一遍） | 命令 | 主调 agent | 输出 | | -------------------------- | --------------------------------------- | ------------------------------------- | | `/kickoff <项目>` | product-owner + project-manager | 价值论证 → 立项书(GO/NO-GO) → PRD | | `/design [PRD]` | —（路由） | 按 overview 状态自动指向子命令 | | `/design-overview [PRD]` | architect | 概要设计书（驱动力 + 风格 + 三层 + 模块 + 扩展点识别 + 闸门）| | `/design-detail` | architect + dba + backend-dev | 详设契约 + ⭐ `progress.md` 全功能点清单 | | `/scaffold` | backend-dev + dba + devops | 项目骨架（工程结构 + 父 pom + 公共抽象 + 扩展点空壳 + 初始迁移 + Docker/CI） | | `/ship` | tester + security + project-manager | 测试 + 安全 + 双层功能验收（PRD AC + progress.md 功能点） | ### 反复迭代命令（每个功能点都跑） | 命令 | 主调 agent | 输出 | | -------------------------- | --------------------------------------- | ------------------------------------- | | `/plan <功能点 F-NNN>` | planner | 功能点的阶段化实现计划 + 更新 progress.md 状态 | | `/review` | code-reviewer (+ java-reviewer) | 代码审查报告（含详设契约一致性，严重度分级） | | `/quality-gate` | tester (+ code-reviewer) | 提交前门禁：构建 + 测试 + 覆盖率 + 契约一致性 PASS/FAIL | ### 按需命令（不属于固定流程） | 命令 | 主调 agent | 输出 | | -------------------------- | --------------------------------------- | ------------------------------------- | | `/build-fix` | backend-dev / frontend-dev | Maven/Gradle/pnpm/vite 构建错误定位与修复 | | `/refactor-clean` | code-reviewer + backend-dev/frontend-dev | 死代码清理 | | `/update-docs` | code-reviewer | 文档同步（README / API / CHANGELOG） | | `/update-codemaps` | —（主线程扫描） | 代码映射 `docs/codemap.md` | > v0.3.0：设计阶段拆为概要 + 详细两段，APPROVE 闸门防详设返工 > v0.3.1：实施期命令对齐到功能点颗粒度 > v0.3.2：业务领域档案独立到 `domains/` > v0.3.3：新增 `/scaffold` 命令，补全详设 → 实现之间的"项目骨架"环节 > v0.3.4：design-detail 完成时生成 progress.md 功能点清单；命令按"一次性 / 反复"分组 > v0.3.5：ark-plus 标准模块结构（io.ark / engine / context / platform + 三层 + BOM）；包名 `io.ark.zzsheng.*` + `@author zhouzhensheng` 强制；环境依赖缺失停下来问用户 > v0.3.6：业务子域 6 子模块物理化（api / domain / application / infrastructure / adapter / spring-boot-starter）；context-core 强制 6，generic/supporting 可精简 3 > 设计阶段拆为概要 + 详细两段（v0.3.0 起）。`/design` 是路由入口，会按 `docs/architecture/overview-design.md` 状态自动指向 `/design-overview` 或 `/design-detail`。中间有 APPROVE 闸门防止详设返工。 ## 12 个 Agent | Agent | 模型 | 定位 | | --------------- | ------ | ---------------------------------------------------- | | planner | opus | 任务规划：阶段化、风险评估 | | code-reviewer | sonnet | 通用代码审查 | | java-reviewer | sonnet | Java/Spring Boot 专项审查 | | project-manager | sonnet | 排期、里程碑、风险跟踪、验收报告 | | product-owner | sonnet | PRD、用户故事、验收标准 | | **architect** | opus | **架构驱动力分析 + 风格选择 + 扩展点 + ADR（业务驱动）** | | **backend-dev** | sonnet | **性能极客 + 精准实现 + 海量数据警示（范式无关）** | | frontend-dev | sonnet | Vue3 + TypeScript 实现 | | dba | sonnet | MySQL/PG schema、索引、迁移 | | tester | sonnet | JUnit5/Vitest/Playwright + 性能 + E2E | | devops | sonnet | Docker/K8s/CI/CD/可观测性 | | security | sonnet | OWASP/密钥/CVE/配置审查 | ## 21 个 Skill（按需引用） ### 项目工程结构（1） ⭐ v0.3.5 新 - `project-module-structure.md` - ark-plus 标准模块结构（`io.ark` / `ark-engine` 纯技术封装 / `ark-context` 三层业务 / `ark-platform` 启动层 + BOM + 父 pom）；包名 `io.ark.zzsheng.*` + Java 文件强制 `@author zhouzhensheng` ### 架构与范式（8） ⭐ - `architecture-paradigm-selection.md` - 范式选择决策树（风格选择工具） - `product-layered-architecture.md` - 产品架构分层（通用 / 支撑 / 核心层） - `ddd-tactical-patterns.md` - DDD 战术：聚合 / 值对象 / 仓储 / 领域事件 - `ddd-strategic-patterns.md` - DDD 战略：限界上下文 / ACL / 上下文映射 - `reactive-spring-webflux.md` - 响应式编程 - `monolith-microservice-switchable.md` - 单体可切换分布式 - `event-driven-architecture.md` - 事件驱动架构风格 - `extension-points-design.md` - 扩展点：SPI / 策略 / 责任链 / Conditional Bean ### 后端工程（8） - `springboot-microservice-patterns.md` - Spring Boot 微服务通用模式 - `java-coding-standards.md` - 现代 Java 工程规范 + Bean Validation - `jpa-hibernate-patterns.md` - JPA/Hibernate：实体 / N+1 / 批处理 - `backend-caching-patterns.md` - 缓存模式：一致性 / 击穿穿透雪崩 - `springboot-security.md` - Spring Security 认证授权实现 - `java-build-troubleshooting.md` - Maven/Gradle 构建错误排查 - `api-design-rest.md` - REST API 设计 - `owasp-security-checklist.md` - 安全检查清单 ### 前端 / 数据库 / 测试 / 部署（4） - `vue3-composition-patterns.md` - Vue3 Composition API - `mysql-postgres-schema-design.md` - 数据库设计 + PostgreSQL 优化 - `tdd-java-vue.md` - 测试范式 - `docker-k8s-deployment.md` - 容器化、Docker Compose、K8s 部署 ## 2 个领域档案（独立目录 `domains/`，v0.3.2 起从 skills/ 移出） 业务领域档案是"业务上下文参考资料"而非"按需引用的知识片段"，单独归类，由 architect / product-owner / kickoff 命令在启动时按顺序解析： 1. 下游项目 `.claude/domain-profile.md`（**优先**） 2. 内置默认 `domains/domain-ami.md` | 档案 | 用途 | |------|------| | `domains/domain-profile-template.md` | 领域档案模板（下游项目复制到 `.claude/domain-profile.md` 自填） | | `domains/domain-ami.md` | AMI 高级量测体系内置默认（国际中立 + 地区差异标注） | ## 4 个 Rule（常驻） | 规则 | 范围 | | ----------- | ---------------------------------- | | common.md | 所有 agent（命名 / 提交 / 文档 / 纪律 + **环境依赖缺失策略** v0.3.5） | | java.md | Java 项目（语言层 + 通用纪律 + **包名 `io.ark.zzsheng.*` + `@author zhouzhensheng` 强制** v0.3.5） | | vue.md | Vue3 + TypeScript | | sql.md | MySQL / PostgreSQL | ## 项目生命周期流程（v0.3.4：一次性 vs 反复迭代分段） ``` ┌─────────────────────────────────────────────────────────────────────────┐ │ 一次性段（项目级，整个项目只跑一遍） │ ├─────────────────────────────────────────────────────────────────────────┤ │ /kickoff → /design-overview → APPROVE 闸门 → /design-detail │ │ │ │ │ ▼ │ │ (PRD) (overview-design.md) docs/api/* │ │ extension-points.md │ │ data-model.md │ │ sequences.md │ │ ADR │ │ ⭐ progress.md │ │ (F-000 + F-001~F-N) │ │ │ │ │ ▼ │ │ /scaffold │ │ (F-000 = 已完成) │ └─────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────────┐ │ 反复迭代段（功能点级，每个 F-NNN 都走一遍） │ ├─────────────────────────────────────────────────────────────────────────┤ │ for each F-NNN in progress.md: │ │ /plan F-NNN → 编码 → /review → /quality-gate │ │ │ │ │ │ │ │ 规划中 实现中 契约审查 PASS/FAIL │ │ ↓ │ │ 已完成 │ └─────────────────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────────────┐ │ 一次性段（项目级，所有功能点完成后跑一次） │ ├─────────────────────────────────────────────────────────────────────────┤ │ /ship → test + security + 双层验收 │ │ └ PRD AC（宏观） │ │ └ progress.md F-NNN（细颗粒度） │ │ └ 批量 F-NNN 状态 → 已验收 │ └─────────────────────────────────────────────────────────────────────────┘ ``` **关键节点**： - **APPROVE 闸门**（概要 → 详细）防止详设返工 - **progress.md** 在 `/design-detail` 完成时生成（含 F-000 + F-001~F-N），是反复段的总账本 - **/scaffold 必经**（详细 → 实现）防止各功能点实现"各自为战" - **反复段循环 N 次**（每个 F-NNN 都走 plan → 编码 → review → quality-gate） - **/ship 双层验收**收尾 ## 三个核心设计决策 ### 1. 范式独立可选 agents / rules / commands **不绑死任何编程范式**。每个项目通过 `/design` 第一步选范式，后续按选定范式工作。 ### 2. 架构从业务出发 `architect` 设计的第一步是**架构驱动力分析**——从 PRD 与领域档案提炼关键质量属性（规模、一致性、演进、合规…），再据此选风格，不套模板。 "单体可切换分布式"（`monolith-microservice-switchable.md`）是 Java 业务系统演进期的**推荐默认**，但非强制：必须用驱动力论证，不合适就选别的，并落 ADR。 > 业务领域知识通过**领域档案**接入（`domain-profile-template.md` + 内置 `domain-ami.md`），换领域不用改 agent。 ### 3. 扩展点是 architect 的核心产物（v0.3.0 起两阶段产出） - **architect** 在 `/design-overview`：**识别**会变化的地方（名称 + 类型 + 用途，不出签名） - **architect** 在 `/design-detail`：**定义**接口形状（全签名 + 注册机制 + 默认实现 + ≥1 示例） - **backend-dev** 实现扩展点（默认实现 + ≥ 1 个示例扩展） - 边界明确不混淆 ### 4. ark-plus 标准模块结构（v0.3.5 起强制，v0.3.6 子域 6 子模块） 所有生成的 Java 项目按统一结构。**业务子域内部再按 DDD 分层切 6 个 Maven 子模块**： ``` ark-plus (groupId=io.ark) ├── ark-dependencies BOM（版本统一） ├── ark-parent 构建配置统一 ├── ark-engine 纯技术封装（engine-core/web/data/cache/mq/security/monitor/test） ├── ark-context 业务限界上下文 │ ├── context-generic 通用层（认证/字典/i18n/审计） │ ├── context-supporting 支撑层（通知/打印/工作流） │ └── context-core 核心层 │ └── core-<子域>/ ⭐ v0.3.6 强制 6 子模块： │ ├── -api 零依赖接口契约 + DTO │ ├── -domain 纯 POJO 领域（聚合/值对象/仓储接口） │ ├── -application 用例编排 │ ├── -infrastructure 仓储实现 + 外部适配 │ ├── -adapter Controller / Dubbo（实现 api） │ └── -spring-boot-starter 自动装配入口 └── ark-platform 平台启动层（monolith / gateway / 各微服务启动器） ``` - **包名根**：`io.ark.zzsheng.{engine|context|platform}.<子模块>` - **Java 文件署名**：每个 .java 必含 `@author zhouzhensheng` - **跨业务子域调用**：只引对方 `-api`，单体↔微服务切换业务零改动 - 详见 `skills/project-module-structure.md` ### 5. 环境依赖不后台自动装（v0.3.5 起） `/scaffold` / `/build-fix` / `/quality-gate` / `/ship` 检测到本地工具缺失（mvn / docker / pnpm / kubectl 等）或需要远程 Linux 服务器，**停下来问用户**，由用户决定自装、提供远程资源还是跳过——不调用 `apt/brew/sdkman/winget install`、不假设有 SSH 配置。 ## 目录结构 ``` . ├── .claude-plugin/marketplace.json # 插件清单 ├── README.md # 本文件 ├── INDEX.md # 调用关系索引（维护者必读） ├── LICENSE # MIT ├── CHANGELOG.md # 版本变更 ├── CONTRIBUTING.md # 贡献指南 ├── CLAUDE.md # 项目级 cc 指令 ├── .gitignore ├── commands/ # 13 个 slash 命令 ├── agents/ # 12 个子代理 ├── skills/ # 21 个按需技能（v0.3.5 起含 project-module-structure） ├── domains/ # 2 个业务领域档案（v0.3.2 起独立） ├── rules/ # 4 个常驻规则 ├── hooks/ # 3 个轻量自动化 ├── mcp-configs/ # MCP 外接示例 └── docs/ # 文档 ├── quickstart.md ├── walkthrough.md ├── customization.md └── troubleshooting.md ``` ## 写作约定 - 所有 prompt 中文撰写 - 技术术语保留英文（@Transactional / Spring Boot / DDD / WebFlux 等） - 仅 planner / architect 用 opus，其余 sonnet - 每个 agent 文件 100-220 行 - 每个 skill 文件 200-300 行 ## 推送到 Gitee（首次发布） ```bash cd F:/cc-tools git init git add . git commit -m "feat: cc-tools v0.1.0 初始版本" git remote add origin https://gitee.com/zzsvip/cc-tools.git git branch -M main git push -u origin main ``` 之后在 Gitee 仓库后台： - 完善仓库描述与标签（`claude-code` / `java` / `ddd` / `microservice` / `spring-boot`） - 启用 Issue / Wiki - 设默认分支 `main` - 推荐勾选 "推荐项目"（如果你有权限） ## License [MIT](LICENSE) ## 贡献者 欢迎 PR / Issue。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。