mcpField
Q
questioning

questioning

github.com/desplega-ai生产力36277 次安装今天更新
代码仓库

关于 questioning

questioning 是用于调查具体问题并直接作答的 Claude 技能,默认不创建研究文档。它可指导代码库、库文档和网页调查,并提供后续操作选项。

主要功能

  1. 01按调查类型分析问题
  2. 02搜索代码并读取相关文件
  3. 03查询库文档或网页资料
  4. 04内联回答并附代码引用
  5. 05提供后续操作选项

适用场景

  1. 01在代码库中定位定义
  2. 02了解项目功能的实现方式
  3. 03调查根因或比较不同方案

MCP 相关

该技能可使用 context7 MCP 获取库文档。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/desplega-ai/ai-toolbox --skill questioning

安装后在 Claude Code 中输入/questioning确认已加载。

附带文件template.md

详细介绍

提问

使用研究流程,直接简洁地回答问题。默认不会创建文档——答案就是交付内容。

适用场景

在以下情况下,此技能会启用:

  • 用户调用 /question 命令
  • 其他技能引用 desplega:questioning
  • 用户提出了一个有明确范围的问题,不需要完整的研究文档

理念

这是从问题到答案的最快路径。与会全面记录的 /research 或以互动方式展开探索的 /brainstorm 不同,/question 会直奔主题:

  1. 听取问题
  2. 按需调查
  3. 直接回答
  4. 提供后续步骤

不走形式——不询问自主性、不设置偏好、不商定工作协议。直接回答问题即可。

需要向用户提问时(例如交接或选择后续操作),请遵循 desplega:ask-user 约定,使用 AskUserQuestion。

流程

第 1 步:分析问题

对问题分类,以确定所需的调查方式:

问题类型所需调查示例
事实/位置快速搜索代码库“身份验证中间件定义在哪里?”
概念/原理阅读相关文件“插件系统如何发现技能?”
原因/根因深入阅读并查看历史记录“为什么头脑风暴默认会提供冗长回答?”
比较阅读多个部分“研究技能和提问技能有什么区别?”
外部资源/库context7 或网页搜索“Bun 的 SQLite 驱动如何处理事务?”
第 2 步:调查

根据问题类型使用合适的工具。仅在必要时才启动子 Agent——许多问题只需直接阅读几个文件就能回答。

针对代码库问题:

  • 优先阅读直接提及的文件(使用 Read 工具时不要设置 limit/offset)
  • 需要查找某项内容的位置时,使用 codebase-locator Agent
  • 需要了解某项功能的工作原理时,使用 codebase-analyzer Agent
  • 需要查找某种模式的示例时,使用 codebase-pattern-finder Agent

针对库/框架问题:

  • 使用 context7 MCP 获取文档(resolve-library-id → query-docs)

针对外部/网页问题:

  • 使用 web-search-researcher Agent 查找文档或示例

效率规则:如果阅读 1-3 个文件就能回答问题,直接阅读即可。简单查询不要启动子 Agent。

第 3 步:回答

以内联文本形式呈现答案(而不是文档)。根据问题自然组织内容:

  • 简短回答:用 1-3 句话,并附上 file:line 引用
  • 中等长度回答:用一到两段文字,附上关键引用
  • 详细回答:必要时使用标题组织内容,但保持重点明确

与研究流程不同,你可以:

  • 在问题暗示存在问题时提出改进建议
  • 在问题询问“为什么”时分析根因
  • 在用户询问意见时表达看法(例如“哪种方法更好?”)
  • 直接明确地表达观点,而不是穷尽所有立场、刻意保持中立

务必包含:

  • 对代码库相关主张提供具体的 file:line 引用
  • 有助于阐明答案的代码片段(保持简短)
第 4 步:交接

回答后,使用 AskUserQuestion 提问:

问题选项
"接下来你想做什么?"1. 再问一个问题,2. 将此答案保存到 thoughts,3. 基于此主题开始头脑风暴(→ /brainstorm),4. 基于此主题开始研究(→ /research),5. 完成

根据回答:

  • 再问一个问题:使用 AskUserQuestion 提问 "你的下一个问题是什么?",然后返回第 1 步
  • 保存此答案:按照 cc-plugin/base/skills/questioning/template.md 中的模板,将问答写入 thoughts/<user>/questions/YYYY-MM-DD-<topic>.md。路径选择:如果知道用户姓名,就使用该姓名;否则使用 thoughts/shared/questions/
  • 头脑风暴:建议使用问题主题作为上下文运行 /brainstorm <topic>
  • 研究:建议使用问题主题作为上下文运行 /research <topic>
  • 完成:不再执行其他操作

循环行为

当用户选择“再问一个问题”时,技能会循环执行:

  1. 通过 AskUserQuestion 询问下一个问题
  2. 调查并回答(第 1~3 步)
  3. 再次提供交接选项(第 4 步)

每次迭代相互独立——除非用户明确关联问题,否则不会在不同问题之间累积状态。

学习记录

可选子技能: 如果此工作流中出现了重要的见解、模式、注意事项或决策,可以考虑使用 desplega:learning,通过 /learning capture 记录下来。重点记录有助于他人在未来会话中解决问题的经验。

此技能不做什么

  • 不是研究:不撰写全面的文档,不使用 frontmatter 格式,也不输出多章节内容
  • 不是头脑风暴:不进行苏格拉底式问答循环,也不创建渐进式文档
  • 不是聊天机器人:每个问题都会经过充分调查并提供代码库证据,而非给出浅层回答

评论

支持 Markdown