# Claude Code 插件集合

`Claude Code` `插件` `AI开发` `开发工具` `代码生成`

# Agent Foundry

构建。发布。循环。一个面向开发者的 Claude Code 插件集合。

## 插件列表

| 插件 | 描述 |
|--------|-------------|
| [constitution](plugins/constitution) | 创建、验证并执行项目章程，实现动态治理 |
| [dev-specialisms](plugins/dev-specialisms) | 小众开发者技能（部署、前端氛围、Hashbrown） |
| [devs](plugins/devs) | 面向 Python、Rust、TypeScript、React 和安全领域的专家级编码 Agent 与技能 |
| [flutter-core](plugins/flutter-core) | Flutter 和 Dart 开发工具包，涵盖 UI/UX、状态管理、测试与 ServerPod |
| [git-lovely](plugins/git-lovely) | 优雅的 Git 工作流，支持约定式提交和 GitHub CLI 集成 |
| [ideas](plugins/ideas) | 通过结构化的创意协作，将模糊想法转化为清晰的愿景文档 |
| [image-gen](plugins/image-gen) | 通过 nanobanana MCP 服务器使用 Google Gemini 模型进行 AI 图像生成 |
| [pr-tools](plugins/pr-tools) | 并行 PR 审查 Agent，用于代码质量检查、SDD 任务验证和 TODO 追踪 |
| [readme-and-co](plugins/readme-and-co) | 生成 README、LICENSE、CONTRIBUTING、SECURITY 及 GitHub 模板 |
| [sandbox](plugins/sandbox) | 基于 Docker 的隔离开发环境，专为 Claude Code 设计 |
| [sdd](plugins/sdd) | 规范驱动开发：规格说明、计划、任务、代码库映射与质量门禁 |
| [settings-presets](plugins/settings-presets) | Powerline 状态栏和署名配置预设 |
| [spec-writer](plugins/spec-writer) | 引导式探索流程，用于编写完整的功能规格说明 |
| [utils](plugins/utils) | 插件管理工具：依赖检查、扫描与根路径解析 |
| [worktrees](plugins/worktrees) | 支持并行 AI 开发的 Git worktree 工作流 |

## 安装

添加插件市场，然后安装各个插件：

```bash
claude mcp add-marketplace aaronbassett/agent-foundry
claude plugin install sdd@agent-foundry
```

或直接从仓库安装插件：

```bash
claude install-plugin https://github.com/aaronbassett/agent-foundry/tree/main/plugins/sdd
```

## 开发

### Git Hooks 配置

本仓库使用 [lefthook](https://github.com/evilmartians/lefthook) 管理 Git Hooks。

1. 检查是否已安装 lefthook：`lefthook --version`
2. 激活 Hooks：`lefthook install`
3. Hooks 将在提交和推送时自动运行

### 验证

**自动验证：**
- 提交前（pre-commit）：验证已更改的插件
- 推送前（pre-push）：验证所有插件及插件市场

**手动验证：**
- 所有插件：`scripts/validate-marketplace.sh`
- 单个插件：`scripts/validate-plugin.sh <插件名称>`
- CI 验证：`scripts/ci/validate.sh`

**跳过 Hooks：**

在以下情况下使用 `git commit --no-verify` 或 `git push --no-verify`：
- 紧急热修复
- 仅文档变更
- 需要排查 Hook 问题

注意：GitHub Actions 仍会对所有变更执行验证。

## 许可证

[MIT](LICENSE)