Agents 配置目录

全局配置与自定义扩展，为 AI 编码助手提供统一的规则、技能和工具链。

快速开始

# 1. 克隆配置
git clone https://github.com/OiAnthony/.agents ~/.agents

# 2. 同步到其它 agents（Cursor、Windsurf 等）
bunx @iannuttall/dotagents

# 3. 按需安装 skills
bunx skills add <owner/repo>

更多可用 skills：skills.sh

前置依赖

RTK（Rust Token Killer）

高性能 CLI 代理，减少 60-90% 的 LLM token 消耗。

# 安装
brew install rtk

# 初始化（全局 hook，推荐）
rtk init --global --hook-only

# 验证
rtk --version
rtk gain

其它安装方式

# 快速安装（Linux/macOS）
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

# Cargo 安装
cargo install --git https://github.com/rtk-ai/rtk

agent-browser

浏览器自动化 CLI 工具，供 AI agents 进行网页交互。

# 安装
brew install agent-browser
agent-browser install

其它安装方式

# npm 安装
npm install -g agent-browser
agent-browser install

# Linux 需额外系统依赖
agent-browser install --with-deps

OpenSpec

AI 原生的规范驱动开发（SDD）框架，通过结构化规范实现 AI 与开发者协作。

需要 Node.js 20.19.0+

npm install -g @fission-ai/openspec@latest

OpenSpec 工作流

graph LR
    A["/opsx:explore<br/>探索想法"] --> B["/opsx:propose<br/>提出提案"]
    B -->|new session| C["/opsx:apply<br/>实施任务"]
    C -->|new session| D["/opsx:archive<br/>归档变更"]
    D --> E[完成]

Loading

命令	说明
/opsx:explore	探索想法、调查问题、明确需求，不写代码
/opsx:propose "idea"	生成变更提案及所有产物（proposal / design / tasks）
/opsx:apply	按任务列表逐项实施，可中途修订产物
/opsx:archive	归档已完成的变更

Tips

• 每个阶段之间建议开启新会话，避免上下文过长影响生成质量。
• Apply 中发现设计问题时，暂停实施 → /opsx:explore <change-name> 修订提案 → 新会话 /opsx:apply 继续。

升级

brew upgrade rtk agent-browser

npm update -g @fission-ai/openspec

目录结构

.agents/
├── AGENTS.md              # 全局规则和开发指南
├── RTK.md                 # RTK 使用说明
├── commands/              # 自定义命令脚本
│   └── opsx/              #   OpenSpec 命令
│       ├── apply.md
│       ├── archive.md
│       ├── explore.md
│       └── propose.md
└── skills/                # 自定义技能模块
    ├── agent-browser          # 浏览器自动化
    ├── changelog-generator    # 变更日志生成
    ├── check                  # Waza: 代码检查与审查
    ├── code-review-excellence # 代码审查最佳实践
    ├── design                 # Waza: UI 界面设计
    ├── find-skills            # 技能发现与安装
    ├── frontend-design        # 前端界面设计
    ├── git-commit             # Git 提交工作流
    ├── health                 # Waza: Claude Code 健康检查
    ├── hunt                   # Waza: Bug 调试与排查
    ├── learn                  # Waza: 深度学习与研究
    ├── openspec-*             # OpenSpec 系列技能
    ├── read                   # Waza: URL/PDF 内容读取
    ├── remotion-best-practices # Remotion 视频最佳实践
    ├── skill-creator          # 技能创建与优化
    ├── teach-impeccable       # 设计上下文初始化
    ├── technical-design       # 技术方案设计
    ├── think                  # Waza: 方案规划与思考
    ├── vercel-*               # Vercel 系列最佳实践
    ├── web-design-guidelines  # Web 设计指南
    └── write                  # Waza: 文件创建与写入

核心原则

• 第一性原理思维 — 提炼核心需求，消除伪需求，简化复杂性
• YAGNI & KISS — 不做多余的事，保持简单
• bun 优先 — 默认使用 bun 作为包管理器

致谢

• AGENTS.md 基于 forrestchang/andrej-karpathy-skills，感谢 forrestchang 和 andrej-karpathy。
• Skills 中的 Waza 系列（check、design、hunt、learn、health、read、think、write）源自 tw93/Waza，感谢 tw93。