SuperAPI AI 工具集

odyssey-improve

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:对代码库执行长期改进循环,按目标范围(模块/目录路径、HEAD 或 staged 变更、功能关键词、--all 全项目)进行多维度审计、深度诊断、定向修复、验证、泛化扫描与工程知识沉淀。

主要能力:内置 6 个审计维度——performance(热路径、N+1 查询、内存分配、缓存、包体、懒加载)、security(OWASP Top 10、注入、认证绕过、数据暴露、依赖漏洞、密钥)、architecture(分层违规、循环依赖、耦合、接口契约、SRP)、reliability(错误处理、重试、超时、降级、资源清理)、observability(日志覆盖、指标、链路追踪、错误上报、健康检查)、maintainability(复杂度、死代码、测试覆盖缺口、文档债)。支持 --dimensions 选择子集、--fix-threshold 修复阈值、--skip-fix、--skip-generalize、--auto、-y、-c 恢复、--heartbeat 心跳等标志。

使用方式:先加载基础规范(odyssey-base-codex.md),解析目标并创建会话目录 .workflow/scratch/{YYYYMMDD}-improve-odyssey-{slug}/,写入 session.json、evidence.ndjson、understanding.md;通过 tasks.csv 与 spawn_agents_on_csv 分波次执行调查(Wave 1,2 个 agent)、审计(Wave 2,6 个 agent)、泛化(Wave 3,4 个 agent)。会话产物只能写入该会话目录或 .workflow/state.json;S_FIX 阶段的源码修改在范围内但必须按动作提交。

适用场景:希望周期性、结构化提升既有代码库质量并沉淀工程经验的团队。限制:必须提供有效目标,否则报 E001;路径不存在报 E002;依赖清单缺失仅警告 W001;维度 agent 失败则部分覆盖 W002。诊断假设连续失败 3 次需升级,-y 下可能标记为 INCONCLUSIVE。输出仅限指定路径,不得调用其他写入接口。