{"id":"1cd10de0-0956-4fc5-99da-d62c2c55cb68","shortId":"5mVbbR","kind":"skill","title":"auto-optimize","tagline":"使用 auto-run-agent 对目标项目进行自动化分析、评估、设计和优化。完整流程包括：探索项目现状 → 识别问题 → 设计任务列表 → 创建 runner 环境 → 启动自主执行。适用于任何需要批量优化的项目。","description":"# Auto-Optimize：自主优化流程\n\n使用 auto-run-agent 编排 Claude Code 对目标项目进行持续自动优化。\n\n## 核心原则（从 30+ 实战 session 提炼）\n\n1. **不修比乱修重要** — 每个发现必须分类为 FIX / SKIP / DEFER，SKIP 必须附理由\n2. **扫描维度轮换** — 不要每次只找同一类问题，按维度轮换扫描\n3. **原子验证** — 每个 fix 独立验证，不攒到最后一起跑\n4. **经验持久化** — 踩过的坑写入 MEMORY.md，避免跨 session 重复犯错\n\n## 扫描维度（按轮次轮换）\n\n| 轮次 | 维度 | 扫描目标 |\n|------|------|----------|\n| 1 | Bug | 逻辑错误、死锁、TOCTOU、panic 路径、边界条件 |\n| 2 | 架构 | 命名冲突、职责混乱、模块耦合、类型设计缺陷 |\n| 3 | 重复 | 代码重复、可提取的公共逻辑、copy-paste 痕迹 |\n| 4 | 性能 | 不必要的 clone/alloc、O(n²) 路径、阻塞调用 |\n| 5 | 测试 | 缺失覆盖、脆弱断言、缺少边界用例 |\n| 6 | API | 对标竞品的功能缺口、易用性问题、文档缺失 |\n\n用户可指定维度，否则按项目当前状态自动选择最需要的维度。\n\n## 完整流程\n\n### Phase 1：探索与评估\n1. 确认目标项目路径（用户提供或当前目录）\n2. 深度探索项目：\n   - 读取 README、CLAUDE.md 等项目规范\n   - 分析项目结构、技术栈、依赖\n   - 阅读核心源码，理解架构\n   - 检查 TODO/FIXME、#[allow(dead_code)] 等标记\n3. 按当前维度并行扫描（用 sub-agent 按模块分区扫描）\n4. 输出评估报告给用户，确认优化方向\n\n### Phase 2：分类与设计\n对每个发现进行三分类：\n\n```\nFIX  — 有明确方案，不破坏公开 API，收益 > 风险\nSKIP — 附理由：breaking change / over-engineering / not a bug / intentional design\nDEFER — 需要更多信息或用户决策，记录到 TASKS.md 的 backlog 区\n```\n\nSKIP 判断标准（加载 rules/ 目录下对应语言的规则）：\n- 触及公开 API 签名 → SKIP（除非用户明确要求 breaking change）\n- 只有 1 处使用的\"重复\" → SKIP（提取抽象是过度设计）\n- 不同语义的相似代码 → SKIP（如 Span 内联样式 vs Text 全局样式）\n- 宏能解决但会降低可读性 → SKIP\n\nFIX 任务按依赖排序，生成结构化任务列表：\n```markdown\n## 高优先级\n- [ ] [BUG] 描述 | 文件 | 方案摘要\n- [ ] [BUG] ...\n\n## 中优先级\n- [ ] [DEDUP] 描述 | 文件 | 方案摘要\n- [ ] [DESIGN] ...\n\n## 架构审查（高/中完成后触发）\n- [ ] [ARCH] 全面审查架构合理性，发现问题追加新任务\n\n## 低优先级\n- [ ] [STYLE] ...\n\n## Backlog（DEFER）\n- [ ] [DEFER] 描述 | 需要的信息\n```\n\n### Phase 3：创建 Runner 环境\n1. 在目标项目中 commit 当前状态并创建新分支（如 `auto-optimize`）\n2. 创建 runner 目录结构：\n```\n<runner-dir>/\n├── memory/\n│   ├── TASKS.md      # Phase 2 设计的任务列表\n│   ├── CONTEXT.md    # 项目背景、技术栈、规范、架构概览\n│   └── DONE.md       # 自动生成\n├── workspace/        # 软链接到目标项目\n├── logs/\n└── config.yaml\n```\n\n3. CONTEXT.md 必须包含：\n   - 项目概述和技术栈\n   - 架构概览（关键模块和职责）\n   - 项目规范（引用项目自身的 CLAUDE.md 或编码规范）\n   - 构建和测试命令（每次修改后必须验证）\n   - commit 规范（如有 DCO 要求等）\n   - 当前扫描维度和轮次记录\n\n4. config.yaml 默认配置：\n```yaml\nmax_iterations: 50\nmax_cost_usd: 0\nmax_duration: 6h\nconsecutive_no_progress: 3\nstop_when_empty: true\ncooldown_duration: 15s\nworker_timeout: 30m\nuse_git_detection: true\n```\n\n### Phase 4：执行与验证\n1. 使用 auto-run-agent 启动：\n```bash\ncd /Users/apple/Desktop/code/AI/tool/auto-run-agent\n./orchestrator --dir <runner-dir> --max-iterations 50 --max-cost 0 --max-duration 6\n```\n2. Worker 执行规则：\n   - 每个 fix 完成后立即运行验证命令（从 CONTEXT.md 读取）\n   - 验证失败 → 立即回滚该 fix，标记为 DEFER，继续下一个\n   - 验证通过 → commit，标记为 DONE，更新 DONE.md\n   - 每完成一个 fix，检查是否触发了新问题（回归检测）\n3. 监控命令：\n   - `tail -f <runner-dir>/logs/orchestrator_*.log` — 实时日志\n   - `cat <runner-dir>/memory/DONE.md` — 查看完成记录\n   - `cat <runner-dir>/memory/TASKS.md` — 查看剩余任务\n\n### Phase 5：收尾与学习\n1. 所有 FIX 完成后，运行完整测试套件\n2. bump version（patch for fixes, minor for new features）\n3. 更新项目 MEMORY.md，记录本轮发现的模式和教训\n4. 记录本轮扫描维度，下次自动切换到下一个维度\n\n## 规则系统\n\n规则文件位于 `rules/` 目录，按语言分类。扫描时自动加载对应语言的规则。\n\n```\nauto-optimize/\n├── SKILL.md\n└── rules/\n    ├── universal.md   ← 通用规则（所有语言适用）\n    ├── rust.md        ← Rust 特定规则\n    ├── python.md      ← Python 特定规则\n    ├── typescript.md  ← TypeScript 特定规则\n    └── go.md          ← Go 特定规则\n```\n\n规则格式：每条规则有 ID、类别、描述、示例。Worker 在扫描和修复时参考这些规则来判断 FIX/SKIP。\n\n## 用户交互要点\n- Phase 1 完成后必须向用户展示评估报告，确认优化方向\n- Phase 2 的任务列表展示给用户确认后再创建文件\n- 启动前询问用户：迭代次数、时间限制、是否有成本限制\n- runner 目录默认放在 `~/Desktop/code/AI/<project-name>-runner/`\n- 用户可随时编辑 TASKS.md 插入新任务或调整优先级\n\n## 注意事项\n- auto-run-agent 位于 `/Users/apple/Desktop/code/AI/tool/auto-run-agent`\n- 目标项目必须先 commit 干净再切分支，确保可回滚\n- workspace 用软链接，不复制代码\n- 多个项目可同时运行，互不影响（注意 API rate limit）","tags":["auto","optimize","claude","arsenal","majiayu000","agent-skills","ai-agents","ai-coding-assistant","automation","claude-code","code-review","developer-tools"],"capabilities":["skill","source-majiayu000","skill-auto-optimize","topic-agent-skills","topic-ai-agents","topic-ai-coding-assistant","topic-automation","topic-claude","topic-claude-code","topic-code-review","topic-developer-tools","topic-devops","topic-productivity","topic-prompt-engineering","topic-python"],"categories":["claude-arsenal"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/majiayu000/claude-arsenal/auto-optimize","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add majiayu000/claude-arsenal","source_repo":"https://github.com/majiayu000/claude-arsenal","install_from":"skills.sh"}},"qualityScore":"0.464","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 29 github stars · SKILL.md body (3,505 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T07:01:12.378Z","embedding":null,"createdAt":"2026-04-18T22:24:00.855Z","updatedAt":"2026-05-01T07:01:12.378Z","lastSeenAt":"2026-05-01T07:01:12.378Z","tsv":"'/desktop/code/ai':454 '/logs/orchestrator_':371 '/memory/done.md':375 '/memory/tasks.md':378 '/orchestrator':328 '/users/apple/desktop/code/ai/tool/auto-run-agent':327,465 '0':293,337 '1':40,70,114,116,188,237,318,383,442 '15s':307 '2':48,78,119,147,245,252,342,388,446 '3':52,84,136,233,265,300,367,398 '30':36 '30m':310 '4':58,92,143,283,316,402 '5':100,381 '50':289,333 '6':105,341 '6h':296 'agent':8,29,141,323,463 'allow':132 'api':106,153,181,476 'arch':222 'auto':2,6,22,27,243,321,412,461 'auto-optim':1,21,242,411 'auto-run-ag':5,26,320,460 'backlog':173,227 'bash':325 'break':158,185 'bug':71,165,208,212 'bump':389 'cat':374,377 'cd':326 'chang':159,186 'claud':31 'claude.md':123,273 'clone/alloc':95 'code':32,134 'commit':239,277,358,467 'config.yaml':264,284 'consecut':297 'context.md':254,266,349 'cooldown':305 'copi':89 'copy-past':88 'cost':291,336 'dco':280 'dead':133 'dedup':214 'defer':45,168,228,229,355 'design':167,218 'detect':313 'dir':329 'done':360 'done.md':259,362 'durat':295,306,340 'empti':303 'engin':162 'f':370 'featur':397 'fix':43,55,150,203,346,353,364,385,393 'fix/skip':439 'git':312 'go':429 'go.md':428 'id':433 'intent':166 'iter':288,332 'limit':478 'log':263,372 'markdown':206 'max':287,290,294,331,335,339 'max-cost':334 'max-dur':338 'max-iter':330 'memori':249 'memory.md':61,400 'minor':394 'n':97 'new':396 'o':96 'optim':3,23,244,413 'over-engin':160 'panic':75 'past':90 'patch':391 'phase':113,146,232,251,315,380,441,445 'progress':299 'python':423 'python.md':422 'rate':477 'readm':122 'rule':178,407,415 'run':7,28,322,462 'runner':17,235,247,452,455 'rust':420 'rust.md':419 'session':38,63 'skill' 'skill-auto-optimize' 'skill.md':414 'skip':44,46,156,175,183,191,194,202 'source-majiayu000' 'span':196 'stop':301 'style':226 'sub':140 'sub-ag':139 'tail':369 'tasks.md':171,250,457 'text':199 'timeout':309 'toctou':74 'todo/fixme':131 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-coding-assistant' 'topic-automation' 'topic-claude' 'topic-claude-code' 'topic-code-review' 'topic-developer-tools' 'topic-devops' 'topic-productivity' 'topic-prompt-engineering' 'topic-python' 'true':304,314 'typescript':426 'typescript.md':425 'universal.md':416 'usd':292 'use':311 'version':390 'vs':198 'worker':308,343,437 'workspac':261,470 'yaml':286 '下次自动切换到下一个维度':404 '不修比乱修重要':41 '不同语义的相似代码':193 '不复制代码':472 '不必要的':94 '不攒到最后一起跑':57 '不破坏公开':152 '不要每次只找同一类问题':50 '中优先级':213 '中完成后触发':221 '互不影响':474 '从':35,348 '代码重复':86 '任务按依赖排序':204 '位于':464 '低优先级':225 '使用':4,25,319 '依赖':127 '全局样式':200 '全面审查架构合理性':223 '关键模块和职责':270 '内联样式':197 '分析项目结构':125 '分类与设计':148 '创建':16,234,246 '判断标准':176 '加载':177 '区':174 '原子验证':53 '发现问题追加新任务':224 '只有':187 '可提取的公共逻辑':87 '否则按项目当前状态自动选择最需要的维度':111 '启动':324 '启动前询问用户':448 '启动自主执行':19 '命名冲突':80 '回归检测':366 '在扫描和修复时参考这些规则来判断':438 '在目标项目中':238 '处使用的':189 '多个项目可同时运行':473 '如':195,241 '如有':279 '完成后':386 '完成后必须向用户展示评估报告':443 '完成后立即运行验证命令':347 '完整流程':112 '完整流程包括':12 '宏能解决但会降低可读性':201 '实战':37 '实时日志':373 '对标竞品的功能缺口':107 '对每个发现进行三分类':149 '对目标项目进行持续自动优化':33 '对目标项目进行自动化分析':9 '干净再切分支':468 '引用项目自身的':272 '当前扫描维度和轮次记录':282 '当前状态并创建新分支':240 '必须包含':267 '必须附理由':47 '性能':93 '或编码规范':274 '所有':384 '所有语言适用':418 '执行与验证':317 '执行规则':344 '扫描时自动加载对应语言的规则':410 '扫描目标':69 '扫描维度':65 '扫描维度轮换':49 '技术栈':126,256 '按当前维度并行扫描':137 '按模块分区扫描':142 '按维度轮换扫描':51 '按语言分类':409 '按轮次轮换':66 '探索与评估':115 '探索项目现状':13 '描述':209,215,230,435 '提取抽象是过度设计':192 '提炼':39 '插入新任务或调整优先级':458 '收尾与学习':382 '收益':154 '文件':210,216 '文档缺失':109 '方案摘要':211,217 '时间限制':450 '易用性问题':108 '是否有成本限制':451 '更新':361 '更新项目':399 '有明确方案':151 '构建和测试命令':275 '架构':79 '架构审查':219 '架构概览':258,269 '查看剩余任务':379 '查看完成记录':376 '标记为':354,359 '核心原则':34 '检查':130 '检查是否触发了新问题':365 '模块耦合':82 '死锁':73 '每个':54,345 '每个发现必须分类为':42 '每完成一个':363 '每条规则有':432 '每次修改后必须验证':276 '注意':475 '注意事项':459 '测试':101 '深度探索项目':120 '特定规则':421,424,427,430 '独立验证':56 '环境':18,236 '理解架构':129 '生成结构化任务列表':205 '用':138 '用户交互要点':440 '用户可指定维度':110 '用户可随时编辑':456 '用户提供或当前目录':118 '用软链接':471 '痕迹':91 '的':172 '的任务列表展示给用户确认后再创建文件':447 '监控命令':368 '目录':408 '目录下对应语言的规则':179 '目录结构':248 '目录默认放在':453 '目标项目必须先':466 '确保可回滚':469 '确认优化方向':145,444 '确认目标项目路径':117 '示例':436 '立即回滚该':352 '等标记':135 '等项目规范':124 '签名':182 '类别':434 '类型设计缺陷':83 '经验持久化':59 '继续下一个':356 '维度':68 '编排':30 '缺失覆盖':102 '缺少边界用例':104 '职责混乱':81 '脆弱断言':103 '自主优化流程':24 '自动生成':260 '要求等':281 '规则文件位于':406 '规则格式':431 '规则系统':405 '规范':257,278 '触及公开':180 '记录到':170 '记录本轮发现的模式和教训':401 '记录本轮扫描维度':403 '设计任务列表':15 '设计和优化':11 '设计的任务列表':253 '评估':10 '识别问题':14 '读取':121,350 '路径':76,98 '踩过的坑写入':60 '轮次':67 '软链接到目标项目':262 '输出评估报告给用户':144 '边界条件':77 '运行完整测试套件':387 '迭代次数':449 '适用于任何需要批量优化的项目':20 '通用规则':417 '逻辑错误':72 '避免跨':62 '重复':85,190 '重复犯错':64 '阅读核心源码':128 '阻塞调用':99 '附理由':157 '除非用户明确要求':184 '需要更多信息或用户决策':169 '需要的信息':231 '项目概述和技术栈':268 '项目背景':255 '项目规范':271 '风险':155 '验证失败':351 '验证通过':357 '高':220 '高优先级':207 '默认配置':285","prices":[{"id":"9e059c5f-7618-42d6-9ad4-9e11449859e3","listingId":"1cd10de0-0956-4fc5-99da-d62c2c55cb68","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"majiayu000","category":"claude-arsenal","install_from":"skills.sh"},"createdAt":"2026-04-18T22:24:00.855Z"}],"sources":[{"listingId":"1cd10de0-0956-4fc5-99da-d62c2c55cb68","source":"github","sourceId":"majiayu000/claude-arsenal/auto-optimize","sourceUrl":"https://github.com/majiayu000/claude-arsenal/tree/main/skills/auto-optimize","isPrimary":false,"firstSeenAt":"2026-04-18T22:24:00.855Z","lastSeenAt":"2026-05-01T07:01:12.378Z"}],"details":{"listingId":"1cd10de0-0956-4fc5-99da-d62c2c55cb68","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"majiayu000","slug":"auto-optimize","github":{"repo":"majiayu000/claude-arsenal","stars":29,"topics":["agent-skills","ai-agents","ai-coding-assistant","automation","claude","claude-code","code-review","developer-tools","devops","productivity","prompt-engineering","python","software-development","typescript","workflows"],"license":"mit","html_url":"https://github.com/majiayu000/claude-arsenal","pushed_at":"2026-04-29T04:12:22Z","description":"52 production-ready Claude Code skills and 7 specialized agents for software development, DevOps, product workflows, and automation.","skill_md_sha":"d94a248f44ee513db79e77ba801427edfb7dfef1","skill_md_path":"skills/auto-optimize/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/majiayu000/claude-arsenal/tree/main/skills/auto-optimize"},"layout":"multi","source":"github","category":"claude-arsenal","frontmatter":{"name":"auto-optimize","description":"使用 auto-run-agent 对目标项目进行自动化分析、评估、设计和优化。完整流程包括：探索项目现状 → 识别问题 → 设计任务列表 → 创建 runner 环境 → 启动自主执行。适用于任何需要批量优化的项目。"},"skills_sh_url":"https://skills.sh/majiayu000/claude-arsenal/auto-optimize"},"updatedAt":"2026-05-01T07:01:12.378Z"}}