Home / All Skills / Workflow & Core Tools / dbs-good-question
Workflow & Core Tools · dontbesilent2025/dbskill

dbs-good-question

Rewrites vague questions into problem specifications that AI agents can reason about, critique, and verify, while assessing the feasibility of automated resolution. Use this skill when users want to clarify a problem, formulate a well-structured question, or evaluate whether an agent can solve it.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit
Author dontbesilent2025GitHub dontbesilent2025/dbskill ↗Stars 10121License CC BY-NC 4.0(Attribution-NonCommercial 4.0 International;仓库根 LICENSE 明文 NonCommercial — 非商业授权,不得商用;GitHub API license=NOASSERTION/Other,因 CC BY-NC 不在 SPDX 常见许可标识内;Copyright (c) 2026 dontbesilent)Commit 8b8e33f1ec
Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

1How It Works & Mechanism

Pure prompt skill: Rewrites vague questions into agent-reasoning-ready, critique-ready, and verifiable problem specifications, assessing the degree of automation feasibility.

skills/dbs-good-question/SKILL.md
你是 dontbesilent 的好问题生成器。
No scripts inside the directory; behavior occurs entirely on the model output side.

Core mission is treating questions as reasoning constraints: good questions compress the search space, expose conflicts, and point toward testable explanations.

skills/dbs-good-question/SKILL.md
**核心使命:让问题承担推理约束。**
The original text explains the significance: the clearer the question, the better an agent can generate candidate explanations that are 'hard to vary'; vagueness forces reliance on default assumptions.

Principle 1 requires pinning down the phenomenon first: rewrites broad questions like 'Why am I not doing well?' into observable, concrete phenomena.

skills/dbs-good-question/SKILL.md
不要直接回答「为什么我做不好」「为什么没人买」「这个能不能做」这类大问题。先把它钉成一个可以观察的现象。
Example of a good question provided is an observation backed by metrics (e.g., 'Over the past 30 days, 80 people inquired in the private channel, but only 2 made a purchase').

Principle 2 treats 'conflict' as the source of a question's power, listing five common types of conflicts (data, behavior, expectation, resource, constraint).

skills/dbs-good-question/SKILL.md
问题的力量来自冲突。没有冲突,Agent 只能泛泛分析。
No conflict = no discriminative power; this serves as the rationale for refusing to jump straight into explanation generation.

Principle 3 defines a constraint field across five categories (target, goal, variable, constraint, feedback) as the skeletal structure of the problem specification.

skills/dbs-good-question/SKILL.md
1. 对象:到底分析谁、哪件事、哪个场景。
The Phase 4 specification template expands precisely on these five categories (problem to analyze, phenomenon, goal, core conflict, background facts, constraints, feedback entry point).

Phase 2 evaluates five inspection points on a 0–2 scale (target, goal, conflict, constraint, feedback), but hides the scoring table from the user by default.

skills/dbs-good-question/SKILL.md
对外输出时,默认不要展示完整评分表。
Defaults to showing only 'Current clarity: Low / Medium / High' and 'Largest gap: {single sentence most impacting agent reasoning}'.

Phase 3 uses six dimensions to evaluate agent solvability, outputting one of four tiers A/B/C/D (Highly automated / Semi-automated / Assisted reasoning / Not suitable for now).

skills/dbs-good-question/SKILL.md
- **A 档:可高度自动化**。Agent 可以直接执行大部分流程。
Six dimensions = clear boundaries, expressible variables, available feedback, testable explanations, executable actions, stable patterns.

Principle 6 requires providing actionable footholds before auditing: rather than scoring first, it highlights breakpoints and clarifies how strong an explanation can currently be provided.

skills/dbs-good-question/SKILL.md
### 原则 6:先给抓手,再做审计
Even if information is incomplete, it permits providing 1–2 low-confidence candidate explanations marked as 'Pending verification'.

Hard constraints on candidate explanations: each must contain mechanism, observable signal, exclusions, and action changes, up to a maximum of 3.

skills/dbs-good-question/SKILL.md
候选解释不超过 3 个。
'- Mechanism: How A leads to B' is one of its fixed fields; low-confidence tier only provides 1–2 items, avoids large tables, and makes no definitive conclusions.

Principle 5 'Do not fake certainty': When information is insufficient, state what is missing first, then provide minimal follow-up questions or minimal observation actions.

skills/dbs-good-question/SKILL.md
信息不足时,不要硬凑解释。
Unknown items in the specification template are explicitly required to be labeled as 'Unknown' rather than fabricated ('Unknown items must be marked as "Unknown"; do not hallucinate settings merely for format completeness.').

Output formats are categorized into five tiers A–E (Default output, Strict audit, Solvability, Full specification, Candidate explanations & critique), selected based on user request.

skills/dbs-good-question/SKILL.md
### 格式 B:严格问题质量审计
Default output is constrained within 5 sections ('6. Control length. Default output should not exceed 5 sections; expand the scoring rubric, full specification, or explanation comparison table only when the user follows up.').

2Core Capabilities

01Input classification (vague question / phenomenon / materials / automation request / mixed)
02Good question 5-point audit and 0–2 scoring (hidden by default)
03Agent solvability 6-dimensional evaluation with A–D 4-tier conclusions
04Problem specification rewriting (7 fields + 4-step instructions for Agent)
05Candidate explanations and 'hard to vary' critiques (mechanism / exclusions / verifiable signals / action changes)
06Low-confidence candidate explanations (providing footholds when info is incomplete but distinct breakpoints exist)
07Minimal next-step decision matrix (action proposals across loose / medium / clear / automated categories)
08Output length and language discipline (default <= 5 sections, maximum 3 questions)

4Recommended Governance & Evidence

Suggested Controls for Safe Operation
For Agent Runtime
Can be auto-loaded
For Administrators
Register source and version
Evidence & Triggers (File Paths & Excerpts)
  • SKILL.md: Pure prompt instructions and rule text; contains no script execution or external side effects
Audit Notes: The evaluation target is the skill's own directory (dbs-good-question/SKILL.md + agents/openai.yaml): zero scripts, zero network endpoints, zero credential reading, and zero disk writes (dangerous token scan: ZERO HITS); behavior occurs entirely on the model output side. Cautionary points involve anchoring risks of low-confidence explanations and scoring subjectivity, which are not code-level risks. Host tool and external platform behaviors are excluded from the rating basis.

5Second-Pass Verification

  • [ok] 纯 prompt、无脚本 — 目录仅 SKILL.md(14622B) + agents/openai.yaml(277B);危险 token 扫描零命中。
  • [ok] 五项检查与评分口径 — 对象/目标/冲突/约束/反馈五项 +「评分使用 0-2 分:」与 0-4/5-7/8-10 三档解释均在原文。
  • [ok] 六维可解性与 A-D 四档 — 六维表格与「- **A 档:可高度自动化**」「- **D 档:暂不适合自动化**」逐字命中。
  • [ok] 候选解释硬约束 — 「每个候选解释必须包含」四要素(机制/可观察信号/排除项/行动变化)+「候选解释不超过 3 个。」
  • [ok] 五档输出格式 — 格式 A-E 五节标题齐全(默认/严格审计/可解性/完整说明书/候选解释与批评)。
  • [ok] 外部依赖为空 — 无 URL/CLI/包依赖;「hard to vary」等术语仅作方法论引用,未指向外部资源。
  • [ok] 无写盘、无凭证读取 — 产出为对话内 markdown(问题说明书/诊断表);grep process.env|API_KEY 零命中。
  • [ok] description 与内容相符 — description 三项承诺(改写成可推理可批评可验证的问题说明书、判断自动化解决程度、用户要求时说清问题)分别对应 Phase 4/Phase 3/Phase 2,无夸大。

6Verdict & Scenarios

  • Provides footholds before auditing: skips displaying scoring rubrics by default, delivering breakpoints and clarity levels first to avoid an interrogation-like experience.
  • Structures problems into actionable deliverables: maps the five constraint field categories directly to specification fields, enabling direct downstream agent execution.
  • Falsifiable candidate explanations: requires four elements (mechanism, observable signal, exclusions, action change) capped at 3 candidate options.
  • Actionable automation assessments: six-dimensional scores map directly to A–D tiers, identifying human-in-the-loop and feedback loop placements.
  • Rejects fake certainty: explicitly states missing information when data is incomplete, strictly banning hallucinations for unknown values.
  • Best for: Ideal for 'having an issue but unable to articulate it clearly': high bookmarks but zero inquiries, stagnant course sales, or wanting to automate a workflow without knowing where to start. Use it to pin down confusion into metric-backed phenomena, rewrite them into constrained problem specifications with feedback loops, and determine whether the task can be delegated to an agent.
    Not for: Not suitable for users who already possess a precise problem definition (it will stop at 'high clarity, providing candidate explanations'); not suitable for execution-only requests needing immediate direct conclusions (it offers candidate explanations and minimal validation actions, not end-to-end execution); not suitable for fact-checking or data collection scenarios (handled by host tools and other skills); not suitable for psychological or emotional venting queries.
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload dbs-good-question.tar.gz
    sha256: 8087542f2ee496de…
    Option B · Copy Guide for Agent
    install.json
    Agents automatically download and verify mirrors from this JSON guide.
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 8b8e33f1ec.