# team-java-copilot

**Repository Path**: yu123_/team-java-copilot

## Basic Information

- **Project Name**: team-java-copilot
- **Description**: 团队 Java AI 编码助手
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-10
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tjc (Claude Code Plugin)

团队 Java AI 编码助手 **Plugin** —— **自包含**：安装这一个 Plugin 后，团队成员即可在 Claude Code 中使用，无需任何外部依赖，也不会被其他 Plugin 干扰。

> 当前版本：**0.8.1**

## 仓库结构

```
tjc/                                    ← 仓库根（也作为 Plugin 根 & Marketplace 根）
├── README.md                            ← 本文件：Plugin 安装与使用说明
├── .claude-plugin/                      ← ⚠️ 注意是带点的目录（Claude Code 识别入口）
│   ├── plugin.json                      ← Plugin 清单（skills/commands）
│   └── marketplace.json                 ← Marketplace 清单
├── agents/                              ← 自定义 Agent（8 个，Claude Code 自动注册）
│   ├── code-architect.md                ← 代码架构师（Opus，只读，方案精炼）
│   ├── code-writer.md                   ← 代码生成器（Sonnet）
│   ├── code-reviewer.md                 ← 代码审查器（Sonnet）
│   ├── tech-architect.md                ← 技术方案审核（Opus）
│   ├── tech-designer.md                 ← 技术方案设计（Opus）
│   ├── java-build-resolver.md           ← 编译错误修复（Sonnet）
│   ├── java-security-reviewer.md        ← 安全专项审查（Sonnet，10维OWASP）
│   └── java-silent-failure-hunter.md    ← 静默失败检测（Sonnet，8类模式）
├── skills/                              ← Plugin Skill（6 个，自包含）
│   ├── team-code-generator/             ← Java 代码生成（三 Agent 协作流水线）
│   ├── team-tech-design/                ← 单项目技术方案生成（双 Agent 协作流水线）
│   ├── team-multi-repo-tech-design/     ← 多项目技术方案（跨仓库契约 + 并行方案）
│   ├── team-code-review/                ← Java 代码审查（5 维度）
│   ├── testing-unit/                    ← 单元测试生成+执行（参数级全覆盖）
│   └── testing-integration/             ← 集成测试方案生成
├── commands/                            ← 斜杠命令（5 个快捷入口）
│   ├── tjc-review.md                    ← /tjc-review  快速代码审查
│   ├── tjc-gen.md                       ← /tjc-gen     代码生成
│   ├── tjc-test.md                      ← /tjc-test    测试生成
│   ├── tjc-design.md                    ← /tjc-design  单项目技术方案设计
│   └── tjc-multi-design.md              ← /tjc-multi-design 多项目技术方案设计
├── rules/                               ← 团队规范（16 个自包含文件）
│   └── *.md                             ← 编码规范文件（每个文件独立，无跨文件引用）
└── templates/                           ← 架构模板（3/4/5 层规范）
    ├── README.md
    ├── 3-layer/
    ├── 4-layer/
    └── 5-layer/
```

## 一键安装（团队成员只需执行 2 条命令）

### 第 1 步：添加团队 Marketplace

```bash
/plugin marketplace add https://gitee.com/yu123_/team-java-copilot.git
```

执行后 Claude Code 会把仓库克隆到 `~/.claude/plugins/marketplaces/team-java-copilot/`，并扫描 `.claude-plugin/marketplace.json`。

### 第 2 步：安装 Plugin

```bash
/plugin install tjc@tjc-marketplace
```

或简写（Claude Code 默认从已知 marketplace 查找）：

```bash
/plugin install tjc
```

### 第 3 步：重启 Claude Code

`/plugin install` 完成后**必须完全退出并重新打开 Claude Code**，新装的 Plugin 才会生效。

### 第 4 步：验证

打开任意 Java 项目目录，启动 Claude Code，输入 `/` 查看斜杠命令列表，确认 Plugin 中的 Skill 已出现在列表中 → **安装成功**。

可用的 5 个斜杠命令：

| 命令 | 适用场景 |
|------|----------|
| `/tjc-design` | 单项目技术方案（PRD → `docs/tech/{需求名}/` 模块化方案目录） |
| `/tjc-multi-design` | 跨 2+ 项目技术方案（先做契约拆分，再各项目并行生成方案） |
| `/tjc-gen` | 按技术方案生成 Java 代码（三 Agent 协作） |
| `/tjc-review` | 对当前改动做 Java 代码审查 |
| `/tjc-test` | 生成单元/集成测试 |

## 自包含设计原则

Plugin 内部所有资源（skills / rules / templates）自给自足，绝不依赖外部：

- ✅ 读取 `rules/*.md`（Plugin 内部）
- ✅ 以插件内置 `rules/` 目录为准
- ❌ **禁止**引用其他 Plugin 的 Skill
- ❌ **禁止**联网拉取模板

## 团队协作约定

### 维护者：发布新版本

每次修改 Plugin（新增 Agent/Skill/规则 等）后：

1. **Bump 版本号**：修改 `.claude-plugin/plugin.json` 中的 `version`（如 `0.1.0` → `0.1.1`）
2. **Commit + Push**：`git add . && git commit -m "..." && git push`
3. **通知团队**：告知有新版本可用

> 版本号必须递增，否则 Claude Code 会认为已安装最新版，跳过更新。

### 团队成员：同步最新版本

```bash
/plugin marketplace update tjc-marketplace
/plugin install tjc@tjc-marketplace
```

安装完成后**重启 Claude Code** 生效。

或在 Claude Code 中执行 `/plugin`，通过 UI 更新。

## ⚠️ 安全提示（Java 团队必读）

由于 Claude Code 在 JetBrains Agent Provider 下默认处于 **bypass permissions mode**，AI 会连续修改文件并执行命令。请团队成员务必遵守：

1. **Git 工作区必须干净**：执行大范围生成前，先 `git status` 确认无未提交改动
2. **复杂任务隔离**：让 AI 在独立的 Git 分支或 worktree 中进行代码生成操作
3. **人工兜底**：AI "已完成" ≠ 达到合并标准。每次生成后必须亲自检查 diff 并执行测试

## 常见问题排查

| 问题 | 排查方法 |
|------|----------|
| `/plugin marketplace add` 报 git 错误 | 确认仓库地址正确；SSH 方式需配置好 key；HTTPS 方式首次可能需要 PAT |
| `/plugin install` 找不到 Plugin | 检查 `~/.claude/plugins/marketplaces/` 下是否成功 clone 了仓库；查看 `marketplace.json` 字段是否合法 |
| 装完斜杠命令里找不到 Plugin 的 Skill | 重启 Claude Code；用 `/plugin` 命令查看 installed 列表确认 |
| 想卸载 | `/plugin uninstall tjc` + `/plugin marketplace remove tjc-marketplace` |