关于 intent-detection
面向未指定 `/phx:` 命令的开发请求路由技能,可根据意图和任务复杂度建议相应命令;建议不构成工作前置条件。
主要功能
- 01按意图匹配工作流
- 02根据任务复杂度提出建议
- 03识别并跳过斜杠命令
- 04置信度与任务范围规则
- 05非强制的命令建议
适用场景
- 01将错误报告引导至调查流程
- 02为多步骤功能选择工作流
- 03不经复杂流程处理小型修复
- 04为库评估建议研究流程
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ oliver-kriska/ claude-elixir-phoenix --skill intent-detection安装后在 Claude Code 中输入/intent-detection确认已加载。
详细介绍
意图检测 — 工作流路由
当用户描述要做的工作,但未指定 /phx: 命令时,分析其意图,并在开始工作前建议合适的工作流。
硬性防护 — 首先检查:如果消息以任何斜杠命令开头
(/phx:、/ecto:、/lv: 或任何其他 /command),此技能不适用。
直接遵循调用的命令 — 不进行路由分析,不提供建议,本技能不输出任何内容。
路由表
| 信号 | 检测到的意图 | 建议 |
|---|---|---|
| "bug"、"error"、"crash"、"failing"、"broken"、堆栈跟踪 | Bug 调查 | /phx:investigate |
| "brainstorm"、"explore idea"、"not sure what I need"、"vague idea"、"let's discuss"、"how to approach" | 创意构思/需求 | /phx:brainstorm |
| "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 |
行为
- 阅读用户的第一条消息
- 根据路由表进行匹配(结合关键词和上下文信号,而非精确匹配)
- 如果匹配到多步骤工作流:“这看起来像是[意图]。我建议使用
[command]— 要我运行它,还是直接开始处理?” - 如果是简单任务(拼写错误、单行修复、配置更改):跳过建议,直接处理
- 如果用户已指定
/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,还是继续完整流程?”
铁律
- 绝不因建议而阻止用户 — 如果用户开始说明情况,就直接开展工作
- 最多建议一次 — 用户忽略第一次建议后,不要再次建议
- 命令是捷径,不是门槛 — 所有工作都可以不使用命令完成
路由逻辑示例
if has_slash_command($ARGUMENTS) -> follow command directly
elif has_stack_trace(message) -> suggest /phx:investigate
elif matches("add|build|implement", message) and multi_step -> suggest /phx:plan
elif matches("fix", message) and small_scope -> handle directly or /phx:quick
elif matches("review|audit", message) -> suggest /phx:review
else -> handle directly (no suggestion)
集成
此技能会在会话开始时被调用,并与以下内容配合使用:
- SessionStart hook(显示插件已加载消息)
- CLAUDE.md 路由说明(被动参考)
- 各个工作流技能(由命令激活)
评论
支持 Markdown