# project-dev-plugin

**Repository Path**: slientes/project-dev-plugin

## Basic Information

- **Project Name**: project-dev-plugin
- **Description**: dddddddddddd
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# silent-dev-plugin

Claude Code 开发插件 - 覆盖软件生命周期全阶段的智能开发助手。

## 简介

silent-dev-plugin 是一个 Claude Code 插件，旨在提升项目开发质量和效率。它支持 Vue 3 前端 + Spring Boot 后端技术栈，具备持续学习和自我优化能力。

**v1.1.0 新特性**: 模块化架构重构，整合功能重复的组件，提升维护效率。

## 安装方式

### 方式一：/plugin 命令安装（推荐）

```bash
# 在 Claude Code 中执行
/plugin install /path/to/silent-dev-plugin
```

或指定远程地址：
```bash
/plugin install https://github.com/jiayou/silent-dev-plugin
```

### 方式二：安装脚本

**Linux/Mac:**
```bash
# 克隆插件
git clone https://github.com/jiayou/silent-dev-plugin.git

# 进入你的项目目录
cd your-project

# 运行安装脚本
/path/to/silent-dev-plugin/install.sh
```

**Windows:**
```cmd
# 运行安装脚本
\path\to\silent-dev-plugin\install.bat
```

### 方式三：手动集成

1. 复制 `.claude/` 目录到项目根目录
2. 复制 `knowledge/` 和 `extensions/` 到项目中
3. 创建 `.claude/settings.json`：

```json
{
  "extends": "./silent-dev-plugin/plugin.json"
}
```

## 卸载

```bash
# 使用卸载脚本
./silent-dev-plugin/uninstall.sh

# 或在 Claude Code 中执行
/plugin uninstall silent-dev-plugin
```

## 功能特性

### 模块化架构 (v1.1.0)

插件采用模块化架构，按功能领域组织组件：

| 模块 | Skill | Agent | Command | 说明 |
|------|-------|-------|---------|------|
| security | security-check | security-agent | security-flow | 综合安全检查 |
| quality | quality-check | quality-agent | qa-flow | 代码质量检查 |
| cache | cache-check | cache-agent | cache-flow | 缓存策略检查 |
| mq | mq-check | mq-agent | mq-flow | 消息队列检查 |
| compliance | compliance-check | compliance-agent | compliance-flow | 合规风险检查 |
| perf | perf-check | perf-agent | observability-setup | 性能分析检查 |
| tech-debt | debt-check | debt-agent | - | 技术债务追踪 |

### Commands (26个)

| 命令 | 功能 |
|------|------|
| `/dev-start` | 一条龙开发流程（需求→设计→编码→测试→评审） |
| `/qa-flow` | 质量保证完整流程 |
| `/security-flow` | 安全审计完整流程 (整合 security-audit) |
| `/refactor-flow` | 渐进式重构流程 |
| `/doc-flow` | 文档生成流程 |
| `/release-check` | 发布前完整性检查 |
| `/api-contract` | 前后端API契约验证 |
| `/tech-design` | 技术方案设计辅助 |
| `/milestone-report` | 里程碑完成报告 |
| `/ops-manual` | 运维手册生成 |
| `/incident-review` | 故障复盘报告 |
| `/tech-radar` | 技术雷达生成 |
| `/qa-system` | 项目知识问答 |
| `/i18n-flow` | 国际化完整流程 |
| `/api-lifecycle` | API生命周期管理 |
| `/observability-setup` | 可观测性配置 |
| `/compliance-flow` | 合规检查流程 |
| `/microservice-design` | 微服务设计流程 |
| `/mq-flow` | 消息队列设计流程 |
| `/cache-flow` | 缓存系统设计流程 |
| `/frontend-arch` | 前端架构设计流程 |
| `/test-pyramid` | 测试金字塔建立 |
| `/release-flow` | 发布完整流程 |
| `/alert-setup` | 告警系统设置 |
| `/ops-setup` | 运维体系建立 |
| `/knowledge-flow` | 知识传递流程 |
| `/template-create` | 项目模板创建 |

### Skills (模块化整合后)

**核心模块 Skills:**

| 技能 | 功能 | 原整合来源 |
|------|------|-----------|
| `/security-check` | 综合安全检查（代码漏洞+依赖漏洞+密钥泄露） | check-security + security-scan + secret-check |

**独立 Skills:**

**需求/设计:**
| 技能 | 功能 |
|------|------|
| `/analyze-wbs` | 生成工作分解结构 |
| `/analyze-story` | 用户故事拆分分析 |
| `/tech-debt` | 技术债务识别 |
| `/adr-gen` | 架构决策记录生成 |
| `/analyze-risk` | 技术风险分析 |

**质量检查:**
| 技能 | 功能 |
|------|------|
| `/check-quality` | 代码质量检查 |
| `/check-complexity` | 代码复杂度分析 |
| `/detect-duplicate` | 重复代码检测 |
| `/sql-optimize` | SQL优化建议 |
| `/review-template` | 生成评审模板 |
| `/check-config` | 配置文件规范检查 |

**重构/优化:**
| 技能 | 功能 |
|------|------|
| `/refactor-plan` | 重构方案生成 |
| `/upgrade-risk` | 依赖升级风险评估 |
| `/bug-analysis` | BUG根因分析 |
| `/pattern-check` | 设计模式应用检查 |
| `/test-strategy` | 测试策略建议 |

**前端专项:**
| 技能 | 功能 |
|------|------|
| `/check-seo` | SEO优化检查 |
| `/check-a11y` | 可访问性检查 |
| `/state-check` | 前端状态管理检查 |
| `/router-check` | 前端路由规范检查 |
| `/component-check` | 组件规范检查 |
| `/style-check` | 样式规范检查 |

**后端专项:**
| 技能 | 功能 |
|------|------|
| `/gateway-check` | Gateway配置检查 |
| `/service-boundary` | 服务边界分析 |
| `/mq-check` | 消息队列规范检查 |
| `/cache-check` | 缓存策略检查 |
| `/es-check` | Elasticsearch规范检查 |
| `/exception-check` | 异常处理检查 |
| `/validation-check` | 参数校验检查 |

**运维/安全:**
| 技能 | 功能 |
|------|------|
| `/analyze-perf` | 性能分析建议 |
| `/env-check` | 环境差异检查 |
| `/sla-check` | SLA配置检查 |
| `/compliance-check` | 合规检查 |

### Agents (模块化整合后)

| Agent | 功能 | 原整合来源 |
|-------|------|-----------|
| security-agent | 综合安全监控（漏洞+密钥） | security-agent + secret-agent |
| auto-fix | 自动修复简单问题 |
| learner | 收集反馈并学习优化 |
| health-monitor | 项目健康监控 |
| arch-analyzer | 项目架构分析 |
| meta-agent | 元Agent，生成新Agent |
| doc-agent | 自动维护项目文档 |
| perf-agent | 后台性能监控分析 |
| risk-agent | 雇佣识别和预警 |
| contract-agent | API契约持续验证 |
| refactor-agent | 后台监控重构机会 |
| bug-agent | BUG趋势分析和预警 |
| debt-agent | 技术债务追踪 |
| upgrade-agent | 依赖升级监控 |
| quality-agent | 代码质量持续监控 |
| compliance-agent | 合规性持续检查 |
| i18n-agent | 国际化持续检查 |
| cost-agent | 成本监控和优化建议 |
| chaos-agent | 混沌工程自动化 |
| alert-agent | 告警趋势分析 |
| release-agent | 发布质量监控 |
| pattern-agent | 设计模式识别和建议 |
| cache-agent | 缓存健康监控 |
| mq-agent | MQ健康监控 |
| dep-agent | 依赖健康持续监控 |

### 兼容别名

为保持向后兼容，旧命令名称自动映射到新命令：

| 旧名称 | 新名称 | 说明 |
|--------|--------|------|
| `/check-security` | `/security-check` | 代码漏洞检查 |
| `/security-scan` | `/security-check` | 依赖漏洞扫描 |
| `/secret-check` | `/security-check` | 密钥泄露检测 |
| `/security-audit` | `/security-flow` | 安全审计流程 |
| `secret-agent` | `security-agent` | 密钥监控Agent |

## 快速开始

```bash
# 一条龙开发流程
/dev-start --requirement "实现用户登录功能"

# 综合安全检查（新）
/security-check
/security-check --type code     # 仅代码漏洞
/security-check --type dep       # 仅依赖漏洞
/security-check --type secret    # 仅密钥泄露
/security-check --history        # 检查Git历史

# 安全审计流程（新）
/security-flow
/security-flow --quick           # 快速检查

# 代码质量检查
/check-quality src/main/kotlin/com/jiayou/

# 添加文档注释
/add-doc UserService.kt

# 生成测试用例
/generate-test UserService.kt

# 质量保证流程
/qa-flow
```

## Git Hooks

插件提供 Git Hooks 自动检查：

| Hook | 触发时机 | 检查内容 |
|------|---------|---------|
| pre-commit | git commit 前 | 格式检查、提交信息规范 |
| pre-push | git push 前 | 质量评分、安全检查 |
| post-commit | git commit 后 | 提交后处理建议 |
| pre-merge | git merge 前 | 合并冲突检查 |

跳过检查：
```bash
git commit --no-verify
git push --no-verify
```

## 配置选项

在 `.claude/settings.json` 中配置：

```json
{
  "config": {
    "enableAutoFix": true,
    "enableHealthMonitor": true,
    "checkOnCommit": true,
    "checkOnPush": true,
    "qualityThreshold": 70,
    "securityThreshold": 80
  }
}
```

## 技术栈支持

| 技术栈 | 支持内容 |
|--------|---------|
| Vue 3 | 组件规范、Props/Events 规范、路由规范 |
| Spring Boot | 分层架构、RESTful API、事务安全 |
| MyBatis/Plus | SQL 安全、Mapper 规范 |
| Redis | Key 规范、缓存策略 |
| Gateway | 路由配置、过滤器规范 |
| Security | 权限控制、认证配置 |
| Spring Cloud | 服务治理、配置管理 |

## 知识库

插件维护以下知识库，持续学习优化：

| 文件 | 内容 |
|------|------|
| best-practices.md | 最佳实践和通用模式 |
| user-feedback.md | 用户反馈和改进记录 |
| rule-execution.md | 规则执行统计数据 |
| problem-solutions.md | 问题解决库 |
| project-stories.md | 项目故事库 |
| templates.md | 项目模板库 |

## 自定义规则

在 `knowledge/rules/custom-rules.md` 中定义项目特有规则：

```yaml
id: my-custom-rule
name: 自定义规则
severity: medium
checks:
  - pattern: "正则表达式"
    message: "问题说明"
```

## 目录结构

```
silent-dev-plugin/
├── .claude-plugin/
│   ├── plugin.json            # 插件配置文件
│   └── marketplace.json       # 市场配置
├── install.sh                 # Linux/Mac 安装脚本
├── install.bat                # Windows 安装脚本
├── uninstall.sh               # 卸载脚本
├── commands/                  # 斜杠命令 (26个)
├── skills/                    # 手动技能 (独立Skills)
├── agents/                    # Agent 定义
├── hooks/                     # Git Hooks (7个)
├── modules/                   # 模块化组件 (v1.1.0)
│   └── security/              # 安全模块
│       ├── SKILL.md           # security-check Skill
│       ├── AGENT.md           # security-agent Agent
│       ├── COMMAND.md         # security-flow Command
│       └── rules.md           # 安全检查规则
├── core/                      # 公共基础设施 (v1.1.0)
│   ├── report-template.md     # 统一报告模板
│   ├── check-engine.md        # 共享检查引擎
│   └── config.md              # 统一配置说明
├── knowledge/                 # 知识库
│   ├── best-practices.md
│   ├── user-feedback.md
│   ├── rule-execution.md
│   ├── problem-solutions.md
│   ├── project-stories.md
│   ├── templates.md
│   └── rules/
│       ├── basic-rules.md
│       ├── techstack-rules.md
│       └── custom-rules.md
├── extensions/                # 技术栈扩展包
│   ├── vue/
│   ├── spring-boot/
│   ├── mybatis/
│   ├── redis/
│   ├── gateway/
│   ├── security/
│   └── cloud/
└── README.md                  # 项目说明
```

## 版本历史

### v1.1.0
- ✅ 模块化架构重构
- ✅ 安全模块整合 (check-security + security-scan + secret-check → security-check)
- ✅ 安全Agent整合 (security-agent + secret-agent → security-agent)
- ✅ 公共基础设施 (report-template, check-engine, config)
- ✅ 兼容别名映射
- ✅ 统一报告格式

### v1.0.0
- ✅ 26个 Commands
- ✅ 54个 Skills
- ✅ 27个 Agents
- ✅ 7个 Hooks
- ✅ 9个知识库文件
- ✅ 7个技术栈扩展包
- ✅ 安装/卸载脚本

## 贡献指南

欢迎贡献新的规则、技能或扩展包：

1. Fork 项目
2. 创建功能分支
3. 提交变更
4. 创建 Pull Request

## 许可证

MIT License

---
**Ciallo～(∠・ω< )⌒☆** 让开发更高效、代码更优雅！