agent-configs

CLI tool to install curated Claude Code and Cursor configurations.

基于 everything-claude-code 项目的最佳实践，提供完整的 Claude Code 和 Cursor 配置共享。

特性

• 交互式菜单 - 上下选择、Enter 进入/安装、Esc 返回
• 双平台支持 - Claude Code + Cursor（默认 Cursor）
• 完整配置 - Commands + Skills + Rules + Agents + Bundles（Hooks 通过 Bundles 提供）
• Bundle 优先 - 相关配置打包，一键安装

快速开始

# 进入交互式菜单（推荐）
npx agent-configs

# 静态列出所有配置
npx agent-configs list --static

# 安装推荐配置
npx agent-configs install --preset recommended

# 安装单个配置
npx agent-configs install plan

# 安装 bundle（推荐）
npx agent-configs install tdd-bundle

交互模式

运行 npx agent-configs 进入交互式菜单：

agent-configs - Claude Code & Cursor 配置共享工具

使用 ↑↓ 选择，Enter 进入，Esc 退出

? 选择类别
❯ Commands (10) ★2 (claude/cursor)
  Skills (8) (claude/cursor)
  Rules (8) ★1 (cursor)
  Agents (6) ★2 (claude/cursor)
  Bundles (6) ★4
  ──────────────
  退出

• ↑↓ - 上下选择
• Enter - 进入子菜单 / 安装
• Esc - 返回上一层 / 退出

配置清单

Commands（10 个）

| 命令 | 说明 | |------|------| | plan | 规划实现方案，WAIT 用户确认后执行 | | code-review | 代码安全和质量审查 | | tdd | TDD 工作流，测试先行 | | learn | 提取可复用 patterns 为 skills | | refactor-clean | 清理死代码和冗余文件 | | e2e | Playwright E2E 测试 | | build-fix | 构建错误自动修复 | | test-coverage | 测试覆盖率检查 | | update-docs | 同步文档 | | update-codemaps | 更新架构文档 |

Skills（8 个）

| Skill | 说明 | |-------|------| | ai-config-architect | AI 配置架构师 - 生成 rules/skills/commands/hooks/agents 配置，支持 Claude/Cursor 双平台 | | tdd-workflow | TDD 完整工作流和最佳实践 | | security-review | 安全审查检查清单 | | coding-standards | 编码规范和风格指南 | | verification-loop | 验证循环模式 | | strategic-compact | 策略性上下文压缩 | | bk-chat-helper | 蓝鲸 AI Chat SDK（业务逻辑层） | | bk-chat-x | 蓝鲸 AI Chat UI 组件库 |

Rules（8 个）

| Rule | 说明 | |------|------| | security | 安全检查清单 | | coding-style | 编码风格（不可变性、文件组织） | | testing | TDD、80% 覆盖率要求 | | git-workflow | Git 提交规范 | | agents | 子代理使用规范 | | patterns | API 响应格式规范 | | performance | 模型选择和上下文管理 | | hooks-guide | Hook 使用文档 |

Agents（6 个）

| Agent | 说明 | |-------|------| | planner | 功能规划专家 | | code-reviewer | 代码审查专家 | | tdd-guide | TDD 指导专家 | | architect | 系统架构专家 | | security-reviewer | 安全审查专家 | | refactor-cleaner | 重构清理专家 |

Bundles（6 个）

| Bundle | 包含内容 | 说明 | |--------|----------|------| | shared-memory | commands + hooks + lib + skills + rules | 跨会话记忆管理系统 | | tdd-bundle | tdd + tdd-workflow + tdd-guide | TDD 完整工作流 | | review-bundle | code-review + security-review + code-reviewer + security-reviewer + hooks | 代码审查全套 - 包含 /code-review 命令、审查 agents、Prettier/TypeScript/console.log 检查 hooks | | planning-bundle | plan + planner + architect | 规划和架构设计 | | bk-chat-bundle | bk-chat-helper + bk-chat-x | 蓝鲸 AI Chat 开发 | | continuous-learning | commands + hooks + lib + skills + rules | 持续学习 - 从会话中自动提取 patterns，保存为 skills/instincts | | docs-bundle | commands + hooks | 文档自动化 - 包含 /update-docs、/update-codemaps 命令及文档更新提醒 hooks |

使用方式

交互式浏览

# 进入交互式菜单
npx agent-configs

# 或使用 list 命令
npx agent-configs list

静态列出配置

# 静态列出所有配置
npx agent-configs list --static

# 按类别列出
npx agent-configs list --static --category commands
npx agent-configs list --static --category skills
npx agent-configs list --static --category rules
npx agent-configs list --static --category agents
npx agent-configs list --static --category bundles

安装配置

# 安装单个配置（默认到 Cursor）
npx agent-configs install plan
npx agent-configs install tdd-workflow
npx agent-configs install security
npx agent-configs install planner

# 安装 bundle（推荐方式）
npx agent-configs install tdd-bundle
npx agent-configs install review-bundle
npx agent-configs install planning-bundle
npx agent-configs install bk-chat-bundle
npx agent-configs install shared-memory
npx agent-configs install continuous-learning
npx agent-configs install docs-bundle

# 指定平台
npx agent-configs install plan --agent claude
npx agent-configs install plan --agent all

# 指定安装级别
npx agent-configs install plan --scope global
npx agent-configs install plan --scope project

# 预设安装
npx agent-configs install --preset minimal
npx agent-configs install --preset recommended
npx agent-configs install --preset full

# 预览模式
npx agent-configs install tdd-bundle --dry-run

卸载配置

npx agent-configs uninstall plan
npx agent-configs uninstall tdd-bundle

预设方案

| 预设 | 包含内容 | 适用场景 | |------|----------|----------| | minimal | plan + code-review + security rule | 快速上手 | | recommended | review-bundle + planning-bundle + 所有 rules | 日常开发 | | full | 全部配置 | 完整体验 |

默认行为

• 不指定 --agent：默认安装到 Cursor
• 不指定 --scope：默认安装到 project 级别
• 使用 --agent all 可安装到所有支持的平台

安装路径

Claude Code

| 类型 | 全局路径 | 项目路径 | |------|----------|----------| | Commands | ~/.claude/commands/ | .claude/commands/ | | Skills | ~/.claude/skills/ | .claude/skills/ | | Agents | ~/.claude/agents/ | .claude/agents/ | | Settings | ~/.claude/settings.json | .claude/settings.json |

Cursor

| 类型 | 全局路径 | 项目路径 | |------|----------|----------| | Commands | ~/.cursor/commands/ | .cursor/commands/ | | Skills | ~/.cursor/skills/ | .cursor/skills/ | | Agents | ~/.cursor/agents/ | .cursor/agents/ | | Rules | - | .cursor/rules/ | | Hooks | - | .cursor/hooks.json |

License

MIT