CommunityArte e 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.

Funciona comClaude 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.

Documentação

需求澄清与任务分诊(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

Habilidades Relacionadas

study8677/Readme.skill

Turn your local Claude Code / Codex CLI history into a shareable, anonymized AI-Native developer profile + viral SVG poster. A skill, not a script — 100% local & read-only.

community

julianoczkowski/brief-to-tasks

Break a design brief into an ordered checklist of independently buildable tasks using vertical slices. Saves as a markdown checklist. Use when user wants to break down work, create tasks from a brief, plan implementation order, or mentions "tasks" or "breakdown".

community

Growth4U-systems/linkedin-comment

Grow on LinkedIn by commenting with value. A Claude Code skill: build your focus group, pick who to comment on, write human-sounding comments. No tokens or APIs.

community

jeffallan/ml-pipeline

Designs and implements production-grade ML pipeline infrastructure: configures experiment tracking with MLflow or Weights & Biases, creates Kubeflow or Airflow DAGs for training orchestration, builds feature store schemas with Feast, deploys model registries, and automates retraining and validation workflows. Use when building ML pipelines, orchestrating training workflows, automating model lifecycle, implementing feature stores, managing experiment tracking systems, setting up DVC for data versioning, tuning hyperparameters, or configuring MLOps tooling like Kubeflow, Airflow, MLflow, or Prefect.

community

YBSbarker/barker-stablecoin-skills

AI Agent Skills for stablecoin yield intelligence — real-time APY from 500+ protocols and 20+ CEX. Free API, no auth required. Powered by Barker.

community

Najnomics/smart-contract-security-auditor

Codex skill for adversarial smart contract security audits

community