Agile Plugins — Development skill for Claude Code

Agile Plugins（Claude Code 插件市场）

[](https://github.com/pig0224/agile-plugins/actions/workflows/validate.yml) [](./LICENSE)

📖 **完整文档**：https://pig0224.github.io/agile-docs/ （命令详解 / 角色说明 / 插件开发指南）

本仓库是 **Claude Code 插件市场（marketplace）**：`.claude-plugin/marketplace.json` 声明本仓库提供的全部插件。**新增插件无需改动 [agile-cli](https://github.com/pig0224/agile-cli)** —— 在本仓库加目录 + 登记 marketplace.json 即可。更新推送后即时生效，无需 npm。

安装

# 方式一：在 agile workspace 内（推荐，marketplace 地址可配置）
agile plugin install agile

# 方式二：手动
claude plugin marketplace add <本仓库 git 地址>
claude plugin install agile@fcc

目录结构

├── .claude-plugin/marketplace.json   # 市场清单：name + source（相对路径）
└── plugins/
    └── agile/                        # SDD/TDD 主插件
        ├── .claude-plugin/plugin.json
        ├── commands/                 # 18 个 /agile:xxx 斜杠命令
        ├── agents/                   # 7 个角色 subagent
        └── skills/sdd-tdd-method/    # 共享方法论（附录 A = 任务目录模板）

新增一个插件

1. 新建 plugins//，内含 .claude-plugin/plugin.json（必填 name）及 commands/agents/skills 等
2. 在 .claude-plugin/marketplace.json 的 plugins[] 追加条目：

{ "name": "", "description": "…", "source": "./plugins/" }

1. 提交推送后，用户侧 agile plugin install 即可安装（CLI 从 .agile/settings.json 的 plugins.marketplace 读取本市场地址）

约定

• 插件名（plugin.json name）= marketplace 条目名 = plugins/ 下目录名，三者一致
• 插件文案全部中文；agent 的 description 用第三人称描述「何时使用」
• 市场名固定 fcc（claude plugin install @fcc）
• plugin.json 不写 version 字段（以 commit SHA 作为更新键），claude plugin validate 的 version warning 可忽略，勿补回 version 字段

开发

claude plugin validate .             # 校验清单（CI 同款）
claude plugin marketplace add .      # 本地市场（命令文件改动后新会话即生效）

详细说明：[docs/design.md](./docs/design.md)；开发约定见 [CLAUDE.md](./CLAUDE.md)。

License

[