~ask

GitHub

~ask是交互式需求澄清工具,通过一问一答厘清目标、方向、范围与约束。仅对话不写代码或文件,基于代码库分析提供推荐选项,最终输出结构化决策摘要及后续执行建议。

skills/commands/ask/SKILL.md hellowind777/helloagents

Trigger Scenarios

用户发起需求讨论但尚未明确具体方案 需要厘清项目方向、价值或范围边界 在编码前进行可行性与前提验证

Install

npx skills add hellowind777/helloagents --skill ~ask -g -y
More Options

Non-standard path

npx skills add https://github.com/hellowind777/helloagents/tree/main/skills/commands/ask -g -y

Use without installing

npx skills use hellowind777/helloagents@~ask

指定 Agent (Claude Code)

npx skills add hellowind777/helloagents --skill ~ask -a claude-code -g -y

安装 repo 全部 skill

npx skills add hellowind777/helloagents --all -g -y

预览 repo 内 skill

npx skills add hellowind777/helloagents --list

SKILL.md

Frontmatter
{
    "name": "~ask",
    "policy": {
        "allow_implicit_invocation": false
    },
    "description": "交互式需求澄清 — 一问一答厘清目标、方向、范围与约束,纯对话不创建文件(~ask 命令)"
}

Trigger: ~ask [description]

~ask 是交互式需求澄清命令,用于在不写文件、不进入执行、不激活完整项目流程的前提下,通过一问一答帮用户厘清目标、比较方向、判断价值、收缩范围、挑战前提。 兼容别名:~idea(逐步废弃)。

铁律

  • 只讨论,不编写实现代码,不创建项目文件,不执行实现操作
  • 不创建 .helloagents/
  • 不创建或更新当前项目存储中的 state_path;同样禁止更新知识库文件、方案包或项目级规则文件
  • 不生成方案包
  • 不执行会改变工作区或外部状态的命令
  • 不默认使用子代理
  • 每次只问一个问题,不一次性抛出多个问题
  • 每个问题必须给出推荐选项和理由,不让用户从空白开始思考

交互模式

核心规则

一问一答,逐条推进:

  1. 一次只问一个问题。不批量提问,不生成问题清单。问完一个、用户回答、再问下一个。
  2. 优先选择题。每个问题给出 2-3 个选项,标注推荐项及理由。选项使用数字编号,格式遵循全局「选择确认」规则;用户回复数字即可选择,也可以直接输入自己的想法。
  3. 你主动读代码库。如果答案能从现有代码中找到(命名规范、配置模式、现有抽象、类似实现),你自己去找,不打扰用户。连续解决多个问题而不需要用户输入才是好的 ~ask 会话。
  4. 覆盖核心维度。在对话中自然覆盖以下维度,不分阶段、不填表:
    • 方向:有哪几种可行做法?各自优劣是什么?
    • 价值:这件事值得现在做吗?最痛的人是谁?不做会怎样?
    • 范围:最小可验证切口是什么?做多大的版本?先做哪一块?
    • 前提:哪些假设最可疑?如果前提不成立会怎样?最省成本的验证方式是什么?
  5. 用户可随时重定向。用户说"其实都不是——我要的是这样"时,你立即沿新方向继续,不坚持原选项。

交互节奏

  • 已有代码库:你先静默读 5-15 个相关文件,基于代码证据形成假设,再以选择题形式逐条确认
  • 全新项目:直接从最高不确定性的决策开始问
  • 每个问题用户通常 5-10 秒回答
  • 整个交互澄清过程通常约 10 分钟

流程

1. 快速理解问题

  • 用一句话重述用户当前要解决的问题
  • 明确讨论目标:是"不知道有哪些做法"、"不确定值不值得做"、还是"不知道该做多大"
  • 已有项目时,静默扫描相关代码(不向用户展示扫描过程),形成内部假设

2. 交互澄清(核心阶段)

按交互模式核心规则,逐条推进。默认从最高不确定性的决策开始:

  • 方向不明确 → 先问方向
  • 范围有争议 → 先问范围
  • 前提可疑 → 先挑战前提
  • 都不确定 → 先问最影响后续决策的那个

遇到以下信号时自然收束:

  • 用户连续确认推荐选项,无额外补充 → 方向已收敛
  • 关键决策全部有明确答案 → 可以汇总
  • 用户说"可以了"、"就这样"、"开始做吧" → 立即汇总

3. 汇总决策

对话结束时,输出结构化选择摘要:

  • 目标:要解决什么问题
  • 选定方向:选了什么做法,为什么
  • 范围边界:做多大、先做哪块、明确不做哪些
  • 已验证的前提:确认了哪些关键假设,搁置了哪些
  • 悬而未决:还有哪些决策需要在后续阶段进一步明确

摘要用简洁列表,不写段落叙述。

4. 给出升级路径

根据交互澄清的结果,推荐下一步:

  • 已厘清方向,可以形成方案 → ~plan
  • 已厘清需求,可以直接实现 → ~build
  • 需要重型产品规格 → ~prd
  • 想让 你 自动执行完整流程 → ~auto

如果用户在 ~ask 过程中转而明确要求写文件、改代码、创建知识库或执行命令,不在 ~ask 内偷偷写文件;改为按最合适的升级路径继续。

快速通道

用户明确表示"直接做,不用问我"、"按默认来"、"你决定"时,你 基于代码分析直接给出推荐方向和升级路径,跳过逐条交互。

输出要求

  • 先给结论,再给依据
  • 不做"点子堆砌"——不列一堆方向让用户自己挑
  • 不把尚未确认的假设伪装成事实
  • 不把"可以做很大"默认当成推荐答案
  • 涉及视觉/交互时,选项必须具体到可执行特征

Version History

  • 79c0b48 Current 2026-08-20 08:24

Same Skill Collection

skills/commands/auto/SKILL.md
skills/commands/loop/SKILL.md
skills/hello-api/SKILL.md
skills/hello-data/SKILL.md
skills/hello-errors/SKILL.md
skills/hello-perf/SKILL.md
skills/hello-security/SKILL.md
skills/hello-test/SKILL.md
skills/hello-ui/SKILL.md
skills/hello-write/SKILL.md
skills/_meta/SKILL.md
skills/commands/clean/SKILL.md
skills/commands/commit/SKILL.md
skills/commands/help/SKILL.md
skills/commands/init/SKILL.md
skills/commands/plan/SKILL.md
skills/commands/prd/SKILL.md
skills/commands/qa/SKILL.md
skills/commands/test/SKILL.md
skills/hello-arch/SKILL.md
skills/hello-debug/SKILL.md
skills/hello-reflect/SKILL.md
skills/hello-subagent/SKILL.md
skills/helloagents/SKILL.md
skills/qa-review/SKILL.md

Metadata

Files
0
Version
79c0b48
Hash
f6a59004
Indexed
2026-08-20 08:24

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-25 18:10
浙ICP备14020137号-1 $방문자$