name: 意图检测 description: 从用户的第一条消息检测用户意图,并建议适当的/phx:工作流程命令。在会话开始时自动加载。 user-invocable: false
意图检测 — 工作流程路由
当用户描述工作但没有指定/phx:命令时,分析他们的意图并在开始工作前建议适当的工作流程。
路由表
| 信号 | 检测到的意图 | 建议 |
|---|---|---|
| “bug”、“error”、“crash”、“failing”、“broken”、堆栈跟踪 | 错误调查 | /phx:investigate |
| “add”、“implement”、“build”、“create” + 多步骤 | 新功能 | /phx:plan |
| “review”、“check”、“audit” 代码 | 代码审查 | /phx:review |
| “fix” + 小/特定范围 | 快速修复 | 直接处理或 /phx:quick |
| “refactor”、“clean up”、“improve” | 重构 | /phx:plan(需要范围) |
| “research”、“how to”、“what’s the best” | 研究 | /phx:research |
| “evaluate”、“compare”、“adopt”、“library”、“should we use” | 库评估 | /phx:research --library |
| “test”、“spec”、“coverage” | 测试 | 直接处理或 /phx:plan |
| 描述1-2个文件更改,< 50行 | 小任务 | 直接处理 |
| “deploy”、“release”、“production” | 部署 | /phx:verify 然后部署 |
| “performance”、“slow”、“N+1”、“memory” | 性能 | /phx:perf |
| “PR review”、“review comments”、“address feedback”、“respond to PR” | PR响应 | /phx:pr-review |
| “that worked”、“fixed it”、“problem solved” | 知识捕获 | /phx:compound |
| “enhance plan”、“more detail”、“deepen” | 计划增强 | /phx:plan --existing |
| “triage”、“which findings”、“prioritize fixes” | 发现分类 | /phx:triage |
行为
- 读取用户的第一条消息
- 匹配路由表(使用关键词 + 上下文信号,非精确匹配)
- 如果找到匹配且为多步骤工作流程:“这看起来像[意图]。我建议
[命令]— 想让我运行它,还是我应该直接开始?” - 如果是琐碎任务(拼写错误、单行修复、配置更改):跳过建议,直接执行
- 如果用户已指定
/phx:命令:遵循它,不要重新建议 - 绝不阻塞用户 — 仅建议,非强制
置信度信号
高置信度(立即建议):
- 粘贴堆栈跟踪或错误消息 →
/phx:investigate - “添加[功能]与[多个组件]” →
/phx:plan - “审查我的更改"或"检查此PR” →
/phx:review
中等置信度(带警告建议):
- “修复[事物]” — 可能快速或复杂,基于范围描述建议
- “更新[事物]” — 可能小编辑或重构
低置信度(直接执行):
- 明确提到单个文件
- “将X改为Y”
- 配置或依赖更新
复杂性信号
当任务匹配工作流程命令时,建议前检查复杂性:
琐碎信号(建议/phx:quick或直接处理):
- 明确提到单个文件
- “从Y排除X”、“将X添加到配置”、“重命名”、“将X改为Y”
- 问题 + 解决方案均陈述(“X错误,改为Y”)
- 描述单行修复
复杂信号(建议/phx:plan或/phx:investigate):
- 提到3+个模块或文件
- “间歇性”、“竞态条件”、“有时”、“随机”
- 堆栈跟踪有5+帧
- “跨”、“所有”、“每个”(范围指示器)
覆盖规则:如果用户调用/phx:full但任务匹配琐碎信号:“这看起来像快速修复。想用/phx:quick代替,还是坚持完整周期?”
铁律
- 绝不因建议阻塞 — 如果用户开始解释,直接执行工作
- 最多一次建议 — 如果用户忽略第一次建议,不要重新建议
- 命令是快捷方式,非障碍 — 所有工作都可在无命令下完成
集成
此技能在会话开始时被咨询。它与以下协同工作:
- SessionStart钩子(显示插件加载消息)
- CLAUDE.md路由指令(被动参考)
- 个别工作流程技能(由命令激活)