智能体增强包

当 API 文档与实现代码不一致时（如端点变更未更新规范、集成方反馈差异或 PR 修改路由/参数/响应结构），使用此插件进行审查。

当知识图谱已存在时，用于从图记忆中检索、追踪、解释或检测信息缺口，避免重新加载完整语料库。

用于理解陌生代码库、定位关键入口点或在编辑前总结架构。

当任务过大或过于复杂时，自动拆分为研究、规划、实施、审查和验证等阶段，协调不同专长的子代理并行处理共享依赖的任务。

创建和编辑 JSON Canvas (.canvas) 文件，支持节点、连线及分组。适用于在 Obsidian 中制作思维导图或流程图。

在编写代码前使用，适用于需求模糊、范围不清或缺乏明确验收标准的场景，帮助梳理任务细节。

适用于大规模重构或迁移场景，如跨文件 API 重命名、框架配置迁移等。将变更拆分为可审查的批次，避免一次性提交过大改动。

在结束会话、交还任务或接近上下文限制时使用，确保后续会话或工程师能立即无缝恢复工作。

将提示词路由至本地提供商 CLI（如 codex/gemini/claude）以获取第二意见、审查或规划，并统一调用方式。

用于消除代码库中过度设计的抽象、冗余层级及逻辑，在不改变行为的前提下精简架构。

在陌生代码区域工作、子代理需精准文件上下文或首次搜索遗漏关键文件时，自动执行上下文检索以明确任务范围。

当 CI 流水线失败时，从数千行嘈杂日志中提取真实错误信息。

在用户明确要求时，生成简明的产品开发需求及 YYLO Ledger 实施任务。仅规划请求保留为外部草稿，需确认后才创建记录。

当实现请求模糊或未明确时，通过结构化提问澄清需求，避免自主执行导致的误解。

用于审查影响报表、指标或财务逻辑的 SQL，检测查询虽能运行但业务含义已偏离的情况。

在窗口填满、阶段切换或状态丢失时，智能决策是否压缩代理上下文以优化性能。

当其他本地代理需要一次性获取 Codex CLI 回答，且可接受或受控的交互行为时使用。

在启用、添加或升级 MCP 服务器前进行安全评估，检查配置变更、第三方来源及工具接口风险。

在PR、审查或合并前对dbt变更进行预检，评估模型、快照、种子、宏或语义YAML的影响范围及测试覆盖情况。

当 Claude Code 代理需要将问题、子任务或代码审查委托给本地 Codex 实例时，请使用此插件。

用于设计或审查文件系统 MCP 访问权限，包括路径边界、允许根目录、方法白名单及安全的本地文件操作。

在已安装 Agent Powerups 的仓库中开始工作时使用，适用于匹配本地技能、命令、工作流、钩子配方、AGENTS.md 模板或 MCP 功能的任务。

在开始功能开发或执行实施计划前，创建隔离的 Git worktree。支持智能目录选择与安全验证，确保工作区独立且安全。

用于优化智能体运行循环、卡片包、MCP会话生命周期、工具调用计数及多智能体编排模式。

用于需验证至完全完成的任务，当用户要求“不要停止”或工作跨多轮迭代且需审核确认时使用。

当代码变更导致文档过时（如文件重命名、脚本或环境变量修改）时，自动检测并修复文档与代码的不一致问题。

适用于跨多系统或供应商的发布场景，强调操作顺序与预设回滚方案，防止单步失败污染下游状态。

用于审查或修改需在不同运行或机器间产生完全一致结果的 ML 训练脚本，解决配置相同但结果差异或需精确重现历史结果的问题。

在审查 PR 或变更计划时，根据代码涉及认证、支付、加密等高风险领域，智能评估所需审查力度并聚焦关键部分。

在遇到任何错误、测试失败或意外行为时，先使用此插件进行系统化分析，再提出修复方案。

围绕工作流、精简架构及上下文感知输出，设计高质量 MCP 服务器。适用于构建或审查面向实际代理任务的 MCP 工具。

用于创建或修改数仓分析项目中的 dbt 维度模型。涵盖四层架构、命名规范、SQL规则、增量策略及测试设计等最佳实践。

适用于低延迟场景，支持多个独立任务并发运行。通过波次式并发工作流处理有界实现或调查任务，而非持久循环或阶段编排。

当已知近期引入了 Bug，但不确定具体由哪个提交导致时，使用此插件通过二分查找快速定位问题根源。

用于排查机器学习训练失败或异常，如损失值为 NaN、内存溢出、形状不匹配或模型无法拟合单批次数据。

用于验证浏览器端 UI 的视觉效果，检测布局错误或回归问题，检查交互组件的可访问性，并执行端到端的浏览器工作流。

在确定、重新评估或逆转重大架构选择时使用，如技术选型和结构模式，防止未来维护者或智能体无意中撤销这些关键决策。

用于设计新智能体的工具定义，或审查现有框架以解决高重试率、调用歧义及静默失败等问题。

用于复现、隔离并修复 Bug，以最小且安全的代码变更解决问题。

当通过大量调试发现棘手Bug、非直观变通方案或隐藏陷阱时，自动将其捕获并转化为可复用的学习技能。

用于在不改变可观察行为的前提下对代码进行结构调整，确保重构过程安全可靠。

用于诊断代理会话历史、中断的工具循环、缺失的工具结果、时间瓶颈及子代理追踪关联。