Agent Optimizer

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

757 stars 102 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add chujianyun/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add chujianyun/skills --skill agent-optimizer
Manual install
git clone --depth 1 https://github.com/chujianyun/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/agent-optimizer ~/.claude/skills/agent-optimizer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Agent Optimizer

基于 **12-Factor AgentOps** 框架,提供 Agent 设计咨询和现有 Agent/Skill 的问题审查与优化建议。

## 核心框架:12-Factor AgentOps

原文来源:https://www.12factoragentops.com  
中文翻译参考:`~/Documents/working/translations/12-factor-agentops/`

12 个因素分三层:

**基础层(I–III)**:单 Agent 可靠性
- **I. 上下文即一切** — 精确管理 context window,按阶段加载,主动压缩
- **II. 用 Git 追踪一切** — issues/learnings/handoffs 全部放 Git,不依赖外部平台
- **III. 一个 Agent 一个任务** — 每次任务用全新 context,禁止复用饱和窗口

**质量层(IV–VI)**:确保工作质量
- **IV. 构建前先调研** — 任何实现前必须有独立调研阶段,产出调研文档
- **V. 外部验证** — Agent 不给自己打分,验证必须来自外部(不同 Agent/模型/测试/人工)
- **VI. 锁定前进的进度** — 通过验证的工作不可回退,形成棘轮效应

**学习层(VII–IX)**:从经验复利
- **VII. 提取经验教训** — 每次会话产出两个成果:工作产物 + 经验教训文档
- **VIII. 知识复利** — 知识必须自动回流:提取→过滤→存储→注入→引用→衰减
- **IX. 衡量重要的事** — 追踪目标达成度,而非活动指标;休眠即成功

**规模层(X–XII)**:多 Agent 工作流
- **X. 隔离工作单元** — 每个 Worker 独立 worktree + 独立 context,零共享可变状态
- **XI. 层级化监督** — 升级流向上传递,不横向流转;工作节点快速失败
- **XII. 从失败中收获智慧** — 失败尝试与成功同等严格地提取和索引

详细说明见 `references/` 目录下各因素的参考文档。

---

## 工作模式

### 模式一:设计咨询

用户提出 Agent 设计问题时:

1. 弄清楚用户的**目标**和**约束**(单 Agent 还是多 Agent?是否已有工作流?)
2. 对照 12 个因素,给出具体设计建议
3. 按层次推进:先基础层够用再考虑规模层
4. 提供具体的结构示例(文件结构、Prompt 设计、交接格式等)

**常见设计问题清单**(引导对话用):
- context 是一直堆还是按阶段清理?
- 有没有独立的调研阶段产出调研文档?
- 验证是由执行者本身完成的吗?
- 知识/教训有没有写回去并能被下次会话检索到?
- 多 Agent 时有没有共享目录或共享 context?

### 模式二:设计审查

用户提交现有 Agent/Skill/工作流时:

1. 先让用户描述(或直接读取)设计内容
2. 按 12 因素逐条扫描,标注违反的因素
3. 输出**审查报告**(格式见下)
4. 按严重程度排序,优先指出影响最大的问题

**审查报告格式:**
Read the full skill on GitHub

Details

Skill name
agent-optimizer
Path
skills/agent-optimizer/SKILL.md
Repo updated
14 November 2026

FAQ

What does the Agent Optimizer skill do?

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

How do I install the Agent Optimizer skill?

Claude Code plugin: /plugin marketplace add chujianyun/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Agent Optimizer popular?

It lives in chujianyun/skills, which has 757 GitHub stars and 102 forks.

Related skills

Add Photo Certificate Watermarks

757

chujianyun/skills

为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览,或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF,默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容,也不用于仅设计 Logo 水印素材。

Images, Video & Audio102

Agent Md Advisor

757

chujianyun/skills

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

AI, LLMs & Agents102

Alltuu Downloader

757

chujianyun/skills

喔图(alltuu.com)云摄影相册批量下载工具。当用户需要从 alltuu.com / m.alltuu.com 相册批量下载原图时使用此技能。支持下载原图(6720x4480 级别),自动处理签名URL,并发下载。适用于 alltuu.com/album/ 相册链接。

Other102

Baize

757

chujianyun/skills

将公开或用户有权访问的 Wiki 完整转换为面向 Agent 的离线知识 Skill,并按原 Wiki 层级保存 Markdown、生成检索索引和逐文档哈希清单,支持无变化不落盘的手动或自动增量更新。当用户要求把 Wiki、文档站或帮助中心做成 Skill、同步已有 Wiki Skill、保持文档目录树或设置 Wiki Skill 自动更新时使用;不用于只摘要单篇网页或绕过登录、付费墙和访问控制。

AI, LLMs & Agents102

Claude Config Advisor

757

chujianyun/skills

审查或设计 Claude Code 项目配置。用于用户提到 `.claude`、`CLAUDE.md`、Claude 配置文件、项目级 Claude 自定义配置、配置结构是否合理、该创建哪些配置文件,或希望从零规划 Claude 配置时使用。默认先审查或诊断,再给方案;只有用户明确要求时,才进一步输出推荐结构或样例文件。

AI, LLMs & Agents102

MCP Builder

617

LeastBit/Claude_skills_zh-CN

构建高质量 MCP(模型上下文协议)服务器的指南,使 LLM 能够通过精心设计的工具与外部服务交互。在使用 Python (FastMCP) 或 Node/TypeScript (MCP SDK) 构建 MCP 服务器以集成外部 API 或服务时使用。

AI, LLMs & Agents96

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.