用途
Extension Detector 是 Aura Frog 插件中的一个自扩展能力技能,版本为 v3.7.0-alpha.3。它的核心目标是:当用户的项目需要自己的技能、规则或命令时,及时发现并提出建议,从而减少重复性摩擦。
核心原则是:Aura Frog 插件只提供固定的技能、规则和命令集合;项目特有的模式应属于项目本身,而不是插件。该技能负责观察用户项目何时会受益于自己的扩展,并提出建议,但绝不自主创建。
硬性规则:该技能创建的任何内容都落在用户项目下的 .claude/ 目录中,绝不写入 aura-frog/。
主要能力
该技能按信号强度进行检测:
- 强信号:用户明确说“我们应该有一个用于 X 的技能/规则/命令”“添加一条规则……”“把这个做成技能”,立即呈现建议。
- 中信号:用户在近期对话中重复同一纠正 3 次以上(“不要做 X”/“总是做 Y”),作为候选规则呈现;同一多步骤流程在本项目中手动调用 3 次以上,作为候选技能呈现。
- 弱信号:项目 README/CONTRIBUTING 引用了 Aura Frog 没有对应命令的工作流,作为候选命令呈现。弱信号需要 2 个以上组合才呈现。
使用方式
当信号触发时,该技能必须遵循强制确认协议:
- 暂停并呈现——绝不将检测作为副作用直接写入文件。
- 显示一行提案——例如:Proposed: project skill "<name>" (.claude/skills/<name>/SKILL.md). Reason: <signal>. Create? (y/n)
- 等待明确同意——y、yes、confirm、go ahead、do it 视为同意;其他任何回复(包括沉默、模糊或“让我想想”)均视为否。
- 若同意:委托给 /aura-frog:extend create <kind> <name>,由该命令负责实际文件编写与审计。
- 若拒绝:放弃提案,不在同一轮内重新呈现,但若信号重复出现则跟踪以便重新检测。
可创建的类型包括:
- skill:路径 .claude/skills/<name>/SKILL.md,用于重复流程的 AI 可发现知识。
- rule:路径 .claude/rules/<tier>/<name>.md,始终加载或按代理加载的护栏。
- command:路径 .claude/commands/<name>.md,用户可调用的斜杠命令。
项目级文件在插件级文件之后加载,因此可以在不修改插件的情况下遮蔽或扩展插件行为。
适用场景
适用于用户在使用 Aura Frog 插件进行项目开发时,反复出现相同的纠正、重复手动执行多步骤流程,或项目文档中引用了插件未覆盖的工作流。该技能帮助将这些项目特有的模式沉淀为项目级扩展。
限制
该技能明确不做以下事情:
- 不直接写入任何文件(委托给 /aura-frog:extend)。
- 不写入 aura-frog/skills/、aura-frog/rules/、aura-frog/commands/——禁止污染插件。
- 即使强信号也不自动创建(人在回路是核心)。
- 不跨项目检测模式(项目隔离;信号仅在当前项目内计数)。
- 不因过去确认而降低检测阈值(每次提案独立)。
检测预算:为防止疲劳,每轮最多 1 条提案,每会话最多 3 条。达到会话上限后,进一步提案推迟到 /aura-frog:extend list(用户主动审查)。
反模式包括:基于单条用户消息检测;从一次相似措辞推断意图;不阅读项目上下文就提出名称;在用户活跃执行中途呈现提案;在同一会话中重新提出被拒绝的想法。
关联项:命令 /aura-frog:extend 是唯一消费者;规则 rules/workflow/extension-policy.md 形式化检测阈值和仅项目 claude 约束;规则 rules/core/no-assumption.md 的确认要求与更广泛的“不确定时询问”原则一致;技能 agent-detector 在扩展会改变代理路由时应参考其行为。