Ring — AI Agent 工程实践技能库
以插件化技能库和专家代理，把 TDD、系统化调试与并行代码评审等成熟工程实践强制嵌入 AI 辅助开发流程。
按维度查看评分与理由
证据显示：CI 工作流显式声明最小 permissions，安装器提供 --dry-run/--force 备份，commit/PR 类技能由工作流控制点约束，dependency 审计技能存在。扣分点：技能通过 hooks 会话启动自动加载（需知情同意的透明度有限）；Mithril 经 go install @latest 安装未固定版本，属供应链弱点；技能会驱动 git commit/push/PR 等外部副作用，防护仅在提示词层面，未经执行验证。
证据显示：hooks 逻辑有充分单元测试，失败消息与退出码明确（--strict、ERROR/WARNING 分级），installer 有 doctor 子命令。扣分点：数量自相矛盾——README 称 76 skills/33 agents，而对象描述为 89/38，同一仓库内数字不一致，直接扣至 1；对 Mithril 及 Lerian 私有库的依赖可用性无法静态确认。
证据显示：明确的多平台支持矩阵（Claude Code/Codex/OpenCode/Cursor/Factory AI）、两种安装机制、面向 Lerian 优先且兼顾外部采用，受众与场景定义充分得 3。扣分点：技能触发依赖前置描述文件质量，运行时触发精度静态无法验证；对 Lerian 内部库（lib-commons、systemplane）的深度绑定限制了外部环境的完整适用性。
证据显示：信息架构清晰（4 插件分层、.archive 归档、marketplace. 单一事实源）、安装文档详尽（含子命令与平台矩阵）、命名稳定性由校验脚本强制 ring: 前缀、Apache-2.0 全文存在、自动 semver 版本工作流含标签与锁步清单更新，均达 3。扣分点：无独立 CHANGELOG 文件证据；维护路径以 Lerian 内部优先，外部用户的维护承诺有限；使用示例在 README 中被截断，FAQ 缺失。
证据显示：76+ 技能覆盖完整交付链，强制工作流（TDD、10-gate、并行评审）边际价值明确，得 3。扣分点：全部技能会话启动自动加载可能带来上下文成本；对 Lerian 专属库的技能（约 14 个迁移/参考类）对外部用户是死重，成本收益对其打折；输出可用性（Standards Compliance 表、评分报告）有描述但静态无法验证质量。
证据显示：README 大量交叉引用具体文件路径（SKILL.md、marketplace.、standards 文档），测试代码作为可核查证据存在。扣分点：'battle-tested' 等强主张无随附证据；跨源印证缺失——技能/代理计数在描述与 README 间冲突，且无第三方来源佐证；事实与推断总体区分尚可但营销性措辞（proven、battle-tested）与可验证事实混排。
- README 与对象描述中的技能/代理计数不一致（76/33 vs 89/38），使用前请以 marketplace. 实际内容为准。
- Mithril 通过 'go install @latest' 安装，版本未固定，存在供应链风险；建议固定到具体版本。
- 技能在会话启动时通过 hooks 自动加载并强制行为约束，属较高权限的提示词注入面；部署前应审查 hooks 与技能内容。
- commit/push/PR 类技能会驱动真实外部副作用，防护仅存在于提示词层面，未经执行验证；生产环境慎用。
- 发布者身份未经策展注册库验证；文档深度绑定 Lerian 内部库，外部团队采用时部分技能价值有限。
这个 Agent 能做什么，适合哪些场景？
Ring 是 LerianStudio 开源的 AI Agent 技能库与工作流系统，以 Claude Code 插件市场形式发布，包含 4 个活跃插件（ring-default、ring-dev-team、ring-pm-team、ring-tw-team）、76 个技能和 33 个专家代理。它通过会话启动钩子自动加载技能清单，要求在任何操作前先检查匹配技能，从而强制执行测试先行开发、证据驱动的调试和分阶段计划执行。核心工作流包括 9 名默认评审员加条件专家的并行代码评审、Gate 0/Gate 8/Gate 9 门控的滚动式开发周期，以及面向小型（4 门）和大型（8 门）功能的产品规划流水线。技能本身与具体 Agent 平台无关，除 Claude Code 外还提供 Codex、OpenCode、Cursor 的原生清单和 Factory AI 的安装器路径。项目采用 Lerian 优先但开源友好的策略，内部专用技能保留在市场中，停用的插件归档于 .archive/ 目录。
Ring 以带 frontmatter 的 SKILL.md 文件定义技能（如 ring:test-driven-development、ring:reviewing-code、ring:running-dev-cycle），通过 default/hooks/session-start.sh 在会话启动时自动生成技能速查并加载。运行时，代理按技能指令执行：TDD 技能强制 RED-GREEN-REFACTOR 循环；ring:reviewing-code 并行调度 9 个默认评审代理（code-reviewer、logic-reviewer、security-reviewer、test-reviewer、nil-reviewer、dead-code-reviewer、perf-reviewer、tenancy-reviewer、commons-reviewer）及按 diff 触发的条件专家（obs-reviewer、systemplane-reviewer、streaming-reviewer），按严重级别聚合报告且不修改文件；ring:running-dev-cycle 按 Gate 0（每任务 TDD/覆盖验证）到 Gate 8 评审、Gate 9 验收的门控执行滚动式分阶段计划。产品规划插件通过 researching-features、writing-prds、writing-trds、designing-api-contracts 等门控产出 PRD、TRD、OpenAPI 契约和数据模型。代码分析流水线可调用外部工具 Mithril（go install github.com/lerianstudio/mithril@latest）做静态分析和 AST 提取。安装由 ring-install.sh 符号链接脚本或各平台的原生插件清单完成。
- 使用 Claude Code 的后端团队，希望强制 AI 助手先写测试再实现，避免跳过验证直接交付代码
- 需要并行多维度代码评审的工程团队，让安全、性能、空指针安全、多租户等专项评审同时运行并按严重级别汇总
- 负责大型后端重构的 Go/TypeScript 工程师，使用 planning-backend-refactor 与 Standards Compliance 报告对照团队规范逐项迁移
- 产品与研发协作的功能规划场景，用 4 门或 8 门工作流依次产出 PRD、TRD、OpenAPI 契约、数据模型和执行计划
- 需要补充 API 参考文档或指南的团队，用 ring-tw-team 的 guide-writer、api-writer、docs-reviewer 代理生成并审查文档
- 进行生产就绪评估的团队，运行 auditing-production-readiness 的 44 维度审计并得到 0-430 的评分报告
这个 Agent 有哪些优点和局限？
- 评审工作流并行运行 9 名默认评审员加条件专家，一次拿到按严重级别（Critical/High/Medium/Low）聚合的完整反馈，且评审员只报告不改代码，职责边界清晰
- 技能通过强制触发条件（"技能适用则必须使用"）和反模式清单，系统性防止 AI 助手跳过测试、未查根因就改代码等常见失败
- 多平台分发：Claude Code、Codex、OpenCode、Cursor 各有原生清单，Factory AI 走安装器，技能本体与平台无关
- 覆盖软件交付全链条：核心质量、35 个开发技能、14 个产品规划技能、4 个技术写作技能，含生产就绪 44 维审计和滚动式开发周期门控
- README 中的收益数据（如 90% 减少 works-on-my-machine 问题、100% 测试覆盖）来自团队自述，缺乏独立可验证的度量方法
- 深度集成 Lerian 内部库生态（lib-commons、lib-observability、lib-systemplane、lib-streaming），非 Lerian 技术栈的团队只能使用通用技能，大量专项技能和评审员价值有限
- 完整代码分析流水线依赖外部 Go 工具 Mithril，需要额外安装 Go 环境；Cursor 平台只能走原生清单，符号链接安装器不支持
- 学习与流程成本高：技能强调强制门控和滚动式分阶段计划，轻量场景或个人快速原型可能感到流程过重
- 仓库元数据标注 Apache-2.0 许可证，但 README 许可证章节写 MIT，存在许可信息不一致，采用前需核实
如何安装或部署这个 Agent？
方式一（符号链接安装器，本地开发）：git clone https://github.com/lerianstudio/ring.git ~/ring && cd ~/ring，然后运行 bash ring-install.sh 进入交互菜单，或指定目标：bash ring-install.sh --claude（Claude Code）、--factory（Factory AI）、--opencode、--codex、--all。子命令包括 install、remove、build、clean、doctor、all，支持 --yes/--dry-run/--force/--verbose 标志。方式二（各平台原生清单）：Claude Code 使用根目录 .claude-plugin/marketplace.（Settings → Plugins 搜索 "ring" 安装）；Codex 使用各插件下 .codex-plugin/plugin.；Cursor 使用 .cursor-plugin/plugin.（仅原生方式，安装器不支持）；OpenCode 使用各插件 .opencode/INSTALL.md，例如在配置中声明 "ring-default@git+https://github.com/lerianstudio/ring.git#main"。ring-default 是基础插件，应与其他 Ring 插件一同安装，因为它提供 using-ring 引导技能。可选依赖：go install github.com/lerianstudio/mithril@latest 以启用 Mithril 代码分析流水线。
如何使用这个 Agent？
安装后启动新的 Claude Code 会话，钩子会自动加载技能并显示可用技能清单（如 ring:using-ring、ring:test-driven-development 等）。第一步始终经过 ring:using-ring：在任何动作、工具调用或写代码之前先检查是否有匹配技能。典型用法：说"给应用添加用户认证"会触发 ring:planning-small-features 规划流程，再由 TDD 技能逐组件实现，最后用 ring:reviewing-code 做并行评审；报告 Bug 会触发证据收集→模式分析→假设验证→带测试修复的四阶段调试流程。评审为只读报告，修复需单独的实施步骤后再跑新一轮评审。技能可通过名称显式调用，开发周期类技能（如 ring:running-dev-cycle）按 phased plan 的 Epic/Task 结构推进并通过门控检查点。