用途
Detect Magic 是一个面向仓库、工作流或系统的结构化扫描技能，用于在采取任何改动之前快速摸清“真正的魔法藏在哪里”——即隐藏的 AI 能力、智能体、自动化与工具钩子。它适合作为前置侦察步骤，也适用于 AI 工具、智能体、起始套件或模型行为相关的扫描请求。
主要能力
- 盘点明显入口：README、包清单、安装文档、scripts/、CI/CD 目录、环境变量模板。
- 向外追踪隐藏能力面：模型提供商、工具注册表、函数调用模式（function-calling schema）、MCP 配置、插件加载器、shell 桥接。
- 识别后台机制：定时任务（cron）、调度器、队列、worker、webhook、事件消费者、通知钩子。
- 指出意外能力、危险边界、缺失的可观测性与扇出点。
- 输出确认机制、推断机制与待跟进未知项组成的紧凑能力地图。
使用方式
执行前先复述目标、成功条件与不可触碰的边界。随后按“明显入口 → 隐藏能力面 → 后台机制”的顺序扫描，最后打包结果。调用示例：
/detect-magic scan this repo for hidden AI tooling, agents, MCP servers, and automation hooks before we change anything
交付物
- 简洁的能力清单，映射所有发现的执行面。
- 风险清单，覆盖隐藏副作用或不可信执行路径。
- 后续技能或下一步行动建议短名单（如 $identify、$zone-of-truth、$glyph-of-warding）。
适用场景
- 改动仓库或系统前需要预检扫描。
- 需要摸清自动化、模型行为与副作用实际所在位置。
- 需要盘点隐藏能力面与意外能力。
限制与注意事项
- 不声称仅有猜测的地方存在“魔法”，必须区分证据与怀疑。
- 不为了证明存在性而执行有风险的钩子、自动化、部署、回滚、webhook 或计费变更。
- 谨慎对待依赖或环境产物：存在二进制文件只能说明可能安装了工具，不能证明仓库自带该能力。
- 必须使用明确的不确定性表述：已确认、推断未确认、仓库证据未知。
- 除 Hermes Agent 与本次会话常规工具集外，无需额外运行时依赖。