CommunityArt & Designgithub.com

yingzhengzhang06-sys/requirement-clarifier

Three-mode triage station for ambiguous requests (growme + change + improve). Native Chinese scenarios, cross-runtime neutral, 30+ skill routing table.

Works withClaude Code~Codex CLI~Cursor
npx skills add yingzhengzhang06-sys/requirement-clarifier

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

需求澄清与任务分诊(Grow / Change / Improve)

一句话钩子先别动手——动手之前先回答"用户到底要什么、有多复杂、从哪里切入"三个问题。

它是"分诊台"——不预设领域、不替你执行。把模糊想法变成结构化需求,把任务堆变成带路由的执行顺序,把现成方案变成可改进清单。然后明确指出下一个该用的 skill,自己不接活。

本 skill 是路由器,按用户问题分派到三个子 skill:

  • growme-mode —— 需求澄清("帮我想想")
  • change-mode —— 任务分诊("先做哪个")
  • improve-mode —— 结构优化("怎么改")

核心定位

任何"不太确定从哪下手"的请求,都先走本 skill 一次。三个动作:

  1. 澄清(growme):把模糊想法变成可执行需求
  2. 分诊(change):把任务堆变成执行顺序
  3. 改进(improve):把现成方案变成可优化清单

回答用户的三个本质问题:

  • 你到底要什么?(growme 输出"需求规格")
  • 该从哪开始?(change 输出"执行顺序")
  • 现在这样对吗?(improve 输出"改进点")

路由分派规则

收到用户输入后,先判断属于哪种模式(可多选、可串行):

用户特征模式例子路由到
表达了结果但路径不清晰growme"我想做一个 AI 教学 skill"growme-mode
有多个任务需要排序或选择change"我手上有 8 个 skill 要精修"change-mode
已有方案但不确认是否最优improve"你看这个 SKILL.md 写得对不对"improve-mode

判定原则

  • 多数请求先做 growme(澄清),再决定要不要串 change / improve
  • 串行顺序:growme → change → improve(先搞清楚要什么,再排序,再审查方案)
  • 明确告知用户当前判断的模式,让用户确认或纠正
  • 不需要分诊时直接说"不需要",不要为了用 skill 而用
  • 单次对话内可能涉及多个模式——按需串行调用

不要路由回自己:分诊完必须指向其他执行 skill,不允许"做完 A 后再用 requirement-clarifier 澄清"。


触发场景

强触发(直接调用):

  • "帮我想想 / 这个怎么做 / 我有个想法" → growme-mode
  • "这些任务怎么排序 / 先做哪个 / 有哪些实现路径 / 帮我分诊" → change-mode
  • "怎么优化 / 还有什么问题 / 帮我看看这个方案 / 审查一下" → improve-mode

弱触发(上下文里有"不确定"语义时调用):

  • 收到一句话需求 + 没有验收标准
  • 任务一摞 + 没说依赖关系
  • 已有方案 + 用户表达"感觉哪里不对"
  • 团队多人对同一目标描述不一致

不触发(明确边界):

  • 信息已完全清楚 → 直接开干,不要为了用 skill 而用
  • 单个明确小问题("X 怎么用")→ 用 AskUserQuestion 直接问
  • 已经是具体领域问题("前端按钮怎么写")→ 路由到 frontend-design / ui-ux-pro-max 等领域 skill
  • 纯写作/纯翻译/纯生成 → 路由到 original-writing / humanizer / content-rewrite

输出格式(路由器视角)

模式判断:growme / change / improve(可组合)

【growme】 → 加载 growme-mode(执行需求澄清)
【change】  → 加载 change-mode(执行任务分诊)
【improve】 → 加载 improve-mode(执行结构优化)

下一步建议:[具体路由到 XX skill / 直接执行 / 进一步澄清]

文件结构(本套件)

requirement-clarifier/             ← 路由器(你在这里)
├── SKILL.md                       ← 本文件:路由 + 触发 + 边界
├── growme-mode/                   ← 子 skill 1:需求澄清
│   ├── SKILL.md
│   └── references/
│       ├── seven-dimensions.md    ← 7 大追问维度
│       ├── ask-question-toolkit.md ← AskUserQuestion 使用技巧
│       └── red-flags.md           ← 常见假澄清反例
├── change-mode/                   ← 子 skill 2:任务分诊
│   ├── SKILL.md
│   └── references/
│       ├── complexity-rubric.md   ← 复杂度判断尺
│       ├── priority-matrix.md     ← P0/P1/P2/P3 矩阵
│       ├── routing-table.md       ← 30+ skill 路由对照表
│       └── parallel-dependency.md ← 依赖与并行
├── improve-mode/                  ← 子 skill 3:结构优化
│   ├── SKILL.md
│   └── references/
│       ├── seven-leverage-points.md ← 7 类改进点
│       ├── smart-criteria.md      ← SMART 原则
│       └── red-flags.md           ← 假改进反例
├── examples/                      ← 真实案例
│   ├── fake-clarification.md      ← 假澄清反例样本
│   ├── fake-triage.md             ← 假分诊反例样本
│   └── fake-improve.md            ← 假改进反例样本
├── test-prompts.json              ← 6 个活体测试样本 + 自检问题
├── README.md                      ← 套件门面(house-style 模板)
├── LICENSE                        ← MIT
└── .claude-plugin/
    └── marketplace.json           ← plugin 双通道

打磨报告已移到 精修skills/13-元skill与治理/打磨报告/requirement-clarifier-打磨报告.md(集中存档,便于看所有 skill 打磨情况)。


Gotchas(路由器层)

❌ 不要做的事

  1. 不要"代替执行"——本 skill 是"分诊台"不是"手术室"。澄清和分诊完成后明确指向下一个执行 skill
  2. 不要"为了用而用"——如果用户输入已足够清晰,直接确认即可
  3. 不要"领域预设"——不预设前端、后端、内容、商业等任何领域
  4. 不要"路由回自己"——分诊完不指向 requirement-clarifier,形成"分诊→执行→验证"闭环
  5. 不要"跳过 growme 直接 change"——任务堆的前提是"已经清楚要什么",否则先澄清
  6. 不要"一次问超过 5 个"——多于 5 个 = 你没在抓重点
  7. 不要"改进点超过 7 个"——多于 7 个 = 你没在排序,在罗列

✅ 判断完成度的标准

输出前问自己:

"用户拿这份输出能直接开干吗?"

  • 能 → 完成
  • 不能 → 哪一步还缺?回去补
  • 拿不准 → 标注"需用户确认 XX 后再开干"

何时读取子 skill

  • growme 相关请求 → 加载 growme-mode/SKILL.md + references/seven-dimensions.md
  • change 相关请求 → 加载 change-mode/SKILL.md + references/priority-matrix.md + references/routing-table.md
  • improve 相关请求 → 加载 improve-mode/SKILL.md + references/seven-leverage-points.md
  • 完成度自检 → 读取本文件 Gotchas 节

字数与结构

  • SKILL.md 本体(路由器):≤ 200 行(当前 ~150 行,达标)
  • 子 skill SKILL.md:≤ 250 行
  • 子 skill references/:按需加载,不灌进主上下文
  • 总骨架文件数:≤ 20

Related Skills

wondelai/refactoring-patterns

Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions "refactor this", "code smells", "extract method", "replace conditional", "technical debt", "move method", "inline variable", or "decompose conditional". Also trigger when cleaning up legacy code, preparing code for new features by restructuring, or identifying which transformation to apply to a specific code smell. Covers smell-driven refactoring, safe transformation sequences, and testing guards. For code quality foundations, see clean-code. For managing complexity, see software-design-philosophy.

community

dabydat/ai-workspace-builder

Claude Code skill that generates a complete, self-managing AI workspace with 17 agents, 6 rules, 14 skills, 8 diagrams, and 12 commands. Stack-agnostic. Zero external dependencies.

community

secondsky/tailwind-v4-shadcn

| Production-tested setup for Tailwind CSS v4 with shadcn/ui, Vite, and React. Use when: initializing React projects with Tailwind v4, setting up shadcn/ui, implementing dark mode, debugging CSS variable issues, fixing theme switching, migrating from Tailwind v3, or encountering color/theming problems. Covers: @theme inline pattern, CSS variable architecture, dark mode with ThemeProvider, component composition, vite.config setup, common v4 gotchas, and production-tested patterns.

community

vchrl/dune-sui-query-builder

An agent skill for building, debugging, and optimizing DuneSQL queries against Sui blockchain data. Works with Claude, Cursor, OpenCode, Codex, Gemini etc

community

actionbook/m13-domain-error

Use when designing domain error handling. Keywords: domain error, error categorization, recovery strategy, retry, fallback, domain error hierarchy, user-facing vs internal errors, error code design, circuit breaker, graceful degradation, resilience, error context, backoff, retry with backoff, error recovery, transient vs permanent error, 领域错误, 错误分类, 恢复策略, 重试, 熔断器, 优雅降级

community

chinnie-14/life-insight-counselor

A Codex skill for life strategy, self-discovery, and career guidance across science and symbolic systems.

community