Agile Cli

agile-cli

[](https://github.com/pig0224/agile-cli/actions/workflows/ci.yml) [](https://github.com/pig0224/agile-cli/actions/workflows/release.yml) [](https://www.npmjs.com/package/agile-cli) [](./LICENSE)

**One root, five drawers** — 一个 workspace 根 + 五个知识/代码抽屉的研发工作区 CLI，设计参考 Chromium 的 [depot_tools/gclient](https://chromium.googlesource.com/chromium/tools/depot_tools/)：`.agile/registry.yaml` 是唯一事实源（≈ DEPS），`agile sync` 把磁盘状态收敛到声明状态。

**本仓库只做 CLI（npm 包）**。配套的两个 git 仓库与本 CLI 解耦，扩展它们不需要本仓库发版：

仓库	职责
agile-plugins	Claude Code 插件市场（SDD/TDD 插件）
agile-templates	项目模板注册中心（registry.yaml + 模板目录）

安装

npm install -g agile-cli

Node ≥ 18，git ≥ 2.30。插件与模板由各自 git 仓库分发，无需 npm。

5 分钟上手

# 1. 初始化工作区（.agile 三个 yaml + 五个抽屉骨架 + git init）
mkdir my-workspace && cd my-workspace
agile init workspace --name my-workspace

# 2. 登记五个抽屉的仓库（公司/团队的 git 地址）
agile repo add tech-specs git@gitlab.corp:specs/tech-specs.git
agile repo add biz-tech-docs git@gitlab.corp:team/biz-tech-docs.git
agile repo add biz-product-docs git@gitlab.corp:team/biz-product-docs.git

# 3. 一键同步（拉齐全部 submodule，幂等可重跑）
agile sync

# 4. 新建项目（模板来自模板注册中心 git 仓库）
agile template list                                   # 查看可用模板
agile init project order-service --template go-service

# 5. 日常
agile status                    # 各仓库 branch/commit/dirty/pin 总览
agile worktree create projects/order-service feature/STO-001   # 隔离开发环境
agile task create STO-001       # process-docs/STO-001 五文档骨架
agile doctor                    # 健康检查（配置/权限/漂移），--fix 自动修复

# 6. 安装 Claude Code 插件（SDD/TDD 流程，来自插件市场 git 仓库）
agile plugin in