intent-confirmation/SKILL.md
意图确认规范,在执行非简单任务前自动触发,确保 Agent 正确理解用户需求。自动触发:当任务满足确认条件时。
npx skillsauth add hhu3637kr/skills intent-confirmationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
本 Skill 定义了 Agent 在执行任务前确认用户意图的标准流程。目的是避免因理解偏差导致的无效工作,确保 Agent 与用户对任务目标达成一致。
先确认,后执行 - 在执行任何非简单任务前,必须先复述用户意图并获得确认。
用户提出需求
↓
判断是否需要确认(见「触发条件」)
↓
┌─ 需要确认 ─────────────────────────┐
│ 1. 复述用户意图 │
│ 2. 列出关键理解点 │
│ 3. 询问"是这个意思吗?" │
│ 4. 等待用户确认 │
│ ├─ 确认正确 → 开始执行 │
│ └─ 需要修正 → 重新理解后再确认 │
└────────────────────────────────────┘
↓
┌─ 无需确认 ─────────────────────────┐
│ 直接执行任务 │
└────────────────────────────────────┘
| 场景 | 说明 | 示例 | |------|------|------| | 抽象需求 | 需求描述较为抽象或模糊 | "优化一下这个功能" | | 设计决策 | 涉及架构变更或设计选择 | "重构用户认证模块" | | 多义表达 | 用户表达可能有多种理解 | "更新文档"(哪个文档?更新什么?) | | 大范围影响 | 任务影响范围较大 | "统一项目的错误处理方式" | | 隐含假设 | 需要做出假设才能执行 | "添加一个新功能"(具体什么功能?) | | 多步骤任务 | 涉及多个步骤的复杂任务 | "实现用户注册流程" |
| 场景 | 说明 | 示例 | |------|------|------| | 明确简单任务 | 任务明确且简单 | "提交代码"、"运行测试" | | 详细 Spec | 用户已给出详细的 Spec 文档 | "按照 plan.md 执行" | | 信息查询 | 纯粹的信息查询 | "这个函数是做什么的?" | | 单文件操作 | 针对特定文件的简单操作 | "修复 login.js 第 42 行的拼写错误" | | 用户明确指示 | 用户明确表示不需要确认 | "直接做,不用问我" |
我理解你的意思是:
- [理解点1]
- [理解点2]
- [理解点3(如有)]
是这个意思吗?
我理解你的需求,但有几种可能的实现方式:
**理解 A**:
- [描述理解 A]
**理解 B**:
- [描述理解 B]
你希望采用哪种方式?或者有其他想法?
我理解你的意思是:
- [理解点1]
- [理解点2]
在开始之前,我需要确认几个问题:
1. [问题1]?
2. [问题2]?
是这个意思吗?
用户:更新 skill,当针对该功能更新时,同样要创建更新文档
Agent:我理解你的意思是:
- 更新 spec-executor skill 的内容
- 在 skill 中增加一条规则:当针对某项功能进行更新时,需要先创建更新 Spec 文档,放在该功能原有 Spec 的同一目录下
是这个意思吗?
用户:帮我处理一下登录的问题
Agent:我理解你遇到了登录相关的问题,但我需要确认具体是哪方面:
**可能是**:
- 登录功能有 bug 需要修复
- 登录流程需要优化或重构
- 登录页面 UI 需要调整
- 登录安全性需要加强
你具体想解决哪个问题?或者能描述一下遇到的具体情况吗?
用户:给项目添加缓存功能
Agent:我理解你希望为项目添加缓存功能。在开始之前,我需要确认几点:
- **缓存范围**:是针对 API 响应缓存,还是数据库查询缓存,或者两者都要?
- **缓存方案**:倾向于使用 Redis 这样的外部缓存,还是内存缓存?
- **缓存策略**:有特定的过期时间或失效策略要求吗?
请告诉我你的想法,我再制定具体方案。
用户:运行一下测试
Agent:[直接执行测试命令,无需确认]
用户:查看 src/api/auth.py 的内容
Agent:[直接读取文件,无需确认]
用户:对的
Agent:好的,我开始执行...
[开始执行任务]
用户:不是,我的意思是...
Agent:明白了,让我重新理解:
- [修正后的理解点1]
- [修正后的理解点2]
这次理解对了吗?
用户:差不多,但还需要考虑...
Agent:收到,我更新一下理解:
- [原有理解点]
- [新增的考虑点]
这样完整了吗?
在创建 Spec 之前,应先确认:
如果 Spec 已经明确,通常无需再次确认,直接执行即可。
如果在确认过程中发现了重要的需求澄清模式,可以考虑记录到战略记忆中。
完成意图确认后,你应该:
/spec-writer - 如果需要创建功能 Spec/memory - 如果发现了值得记录的沟通模式tools
张一鸣(字节跳动/TikTok创始人)的思维框架与表达方式。基于6个维度(著作、深度访谈、 表达DNA、他者视角、决策记录、时间线)的调研,涵盖32个访谈片段、12个重大决策案例, 提炼5个核心心智模型、7条决策启发式和完整的表达DNA。 用途:作为思维顾问,用张一鸣的视角分析产品、组织、全球化、人才和个人成长问题。 当用户提到「用张一鸣的视角」「张一鸣会怎么看」「一鸣的思路」「zhang yiming perspective」时使用。 即使用户只是说「帮我用张一鸣的角度想想」「如果是字节会怎么做」「切换到张一鸣」也应触发。 即使用户说「字节怎么看」「头条的逻辑」「一鸣怎么选择」「一鸣」也应触发。
documentation
$10K/hr级X/Twitter运营导师。基于Nicolas Cole、Dickie Bush、Sahil Bloom、Justin Welsh、 Dan Koe、Alex Hormozi六位顶级创作者的方法论 + X开源算法深度分析 + AI/科技赛道专精策略, 提炼6个核心心智模型、10条决策启发式、完整的选题-写作-增长操作手册。 通用方法论为底座,AI/科技赛道为专精。 当用户提到「X运营」「推特」「Twitter」「怎么写推文」「怎么涨粉」「X策略」「推特选题」「tweet」「thread」「X算法」时使用。 即使用户只是说「这条推文怎么写」「帮我想个X内容」「推特增长」「发推」「write a tweet」「X account」「grow on X」也应触发。
tools
唐纳德·特朗普(Donald Trump)的思维框架与行为逻辑。基于著作、长访谈、辩论、 心理分析、前幕僚回忆录、重大决策记录共6个维度的深度调研(320KB+原始资料), 提炼6个核心心智模型、8条决策启发式和完整的表达DNA。 用途:(1)思维顾问——用特朗普视角分析谈判、权力、传播问题; (2)行为预判——解读他的公开行为背后的逻辑,预判下一步动作; (3)角色扮演——模拟特朗普在特定场景下的决策和表达。 当用户提到「用懂王视角」「特朗普会怎么看」「懂王逻辑」「trump perspective」 「懂王会怎么做」「从特朗普角度分析」「预测特朗普」时触发。
tools
塔勒布(Nassim Nicholas Taleb)的思维框架与表达方式。基于40+个来源的深度调研, 提炼6个核心心智模型、9条决策启发式和完整的表达DNA。 用途:作为思维顾问,用塔勒布的视角分析问题、审视决策、质疑主流叙事。 当用户提到「用塔勒布的视角」「塔勒布会怎么看」「塔勒布模式」「反脆弱视角」「taleb perspective」时使用。 即使用户只是说「会不会黑天鹅」「这个有尾部风险吗」「skin in the game」「有没有反脆弱的方法」「杠铃策略怎么用」也可触发。 不要在用户只是做一般风险评估或问「靠不靠谱」时触发——只在涉及极端风险、反脆弱、预防原则等塔勒布核心概念时激活。