提示词澄清优先
把模糊需求固化成可复用、可检验的提示词与 SKILL.md。
> 30 秒看懂（白话导读）：你脑子里的「我想要个提示词」往往很模糊。本技能先用几个
> 选择题把需求问透，再动手写——没问清不写。需求简单就走「快速模式」（几张卡片直出），
> 需求复杂就走「完整模式」（六段式精雕）。另有一个零负担的「轻量版」prompt-clarify-lite。
>
> 术语表（黑话→人话）：六镜片 = 换个角度看问题；PCTF = 提示词规格书模板；
> 意识流 = 让模型先慢想再答；自辩论 = 自己跟自己抬杠找漏洞；棱镜 = 找结构不变量。
三层合流：hardline 负责"不写废话"，六镜片负责"想得不一样"，thinking 协议负责"想得够深"。
铁律：Context Engineering > Prompt Engineering。先选对上下文负载，再雕文字。
第一铁律：意图未达 100% 不落笔
本技能存在的根本目的，是把"先问透、再制作"变成默认协作契约。
- 接到任何提示词需求，先冻结草稿，绝不边问边写、绝不先给一版"你先看"。
- 用结构化追问把 7 项锁定（目标与场景 / 角色与人设 / 使用者与受众 / 输入与输出形态 /
约束与禁忌 / 成功判据 / 边界异常与工具），且用户显式拍板"就按这个来"，才算 100%。 - 任何一步都禁止自作主张补全用户没说出口的意图——缺失即追问，不脑补。
- 澄清一律以选项方式交互，降低表达成本。这是跨会话延续的契约。
选项式澄清规范（默认交互形态）
每个澄清维度用"选项卡片"呈现，而非抛一道开放问答题：
- 每个维度给 2–4 个候选答案（含一个推荐项置顶），用户点选即可；
- 始终保留 "其他"（自由输入）兜底；
- 一次聚焦 1 个维度；维度多时可分组批量：每组 ≤4 问、用一次选项卡片同时呈现
（7 维 = 2 组），组间复述确认，避免 7 轮来回； - 用户点选后，我用一句话复述其选择 + 标注仍模糊处，再进入下一维度；
- 7 个维度全部点选确认后，输出需求复述卡请用户最终拍板，拍板即解锁制作。
分级门（入口分流 · 双模式路由）
接到需求先评分再路由，避免「小需求走重流程」：
| 评分维度 | 低（→快速） | 中高（→完整） |
|---|---|---|
| 复杂度 | 单轮能说清目标 | 跨会话 / 多约束 / 需资产落盘 |
| 风险 | 个人用、可试错 | 生产用、对外发布、合规敏感 |
| 耐心 | 用户催「快给我」 | 用户要「做到位」 |
- 超轻需求（用户明确「就快速写一条」或场景极简）→ 直接建议走 Lite（
prompt-clarify-lite）。 - 分级门不取代第一铁律：任何路径都必须「拍板后再落笔」。
- 用户可主动说「走快速」或「走完整」，越过自动评分。
When to Use
> 触发矩阵（主触发 + 扩展触发，共 ≥10 入口）：
- 主触发：
写提示词提示词体检澄清锁意图优化提示词 - 扩展触发：
需求太模糊先问后写帮我问清楚promptcln做个技能 - Don't use for：随口问"提示词怎么写"（直接答，别启动流程）；改写认知框架技能（冻结只读）；
简单一次性创建（走skill-creator）；只想极轻快进快出（走 Liteprompt-clarify-lite）。
Prerequisites
- 目标路径：
~/.workbuddy/skills/<name>/SKILL.md（用户级）或.codebuddy/skills/<name>/SKILL.md - 思考层：
references/thinking-protocol.md；对抗层：references/debate-engine.md - 结构层：
references/pctf-template.md；验收层：references/quality-checklist.md - 规范层：
references/hardline-rules.md；深层体检读references/prism-methodology.md - 表达层：
references/style-dna.md；领域包：domains/{legal,coding,writing,data}.md - 共享底座：
references/faq.md（高频疑问）、references/friendly-errors.md（报错自救） - 校验：
scripts/validate_skill.py
How to Run
- 分级门分流：评复杂度/风险/耐心 → 快速 or 完整（见「分级门」）。
- 选项式追问到需求锁定（快速：核心 3 维；完整：7 维；点选 + 复述确认，拍板前不落笔）。
- 规格书 → 三版草案 → 自辩论 → 收敛终版（完整模式；快速模式直接套 PCTF 直出）。
- n≥5 实测：正常 / 边界 / 对抗 / 缺信息 / 超长输入。
- 产出 SKILL.md 时必跑
python3 scripts/validate_skill.py <path>。 - 卡住看
references/friendly-errors.md（报错自救卡）或references/faq.md。 - 改动追加写入
CHANGELOG.md，版本号 +1。
Quick Reference
| 硬线 | 值 |
|---|---|
| description | ≤60 字符，触发词前置，含 : 时双引号包裹 |
| 触发窗口 | 前 57 字符必须自解释 |
| name | 中文或 [a-z0-9-]；中文名放 H1 |
| 正文 | 简单 ≤100 行，复杂 ≤200 行 |
| 分级门 | 低→快速(3维) ｜ 中高→完整(7维) ｜ 超轻→Lite |
| 澄清交互 | 每维度 2–4 选项 + "其他"；点选→复述→下一维度；复述卡拍板解锁 |
| 冲突消解 | 第一铁律 > 选项式规范 > 分级门路由 > 其他 |
Procedure
- 分级门分流。评复杂度/风险/耐心，选快速或完整；超轻建议 Lite。
判据：已确定路径且告知用户；未拍板不落笔。 - 追问锁定（选项式）。快速：核心 3 维（目标与场景 / 输入与输出 / 成功判据），
按需补 2 维；完整：7 维逐一点选。最终出需求复述卡请拍板。
判据：各维均有用户点选（或「其他」自填）；拍板前不得落笔；禁止脑补未确认意图。 - 【完整模式】进化链定位（镜片1）+ 自动补全类比（镜片2）。
判据：写得出坐标；能说"删掉这段会怎样"。 - 【完整模式】写规格书（按
pctf-template.md填 8 项）。
判据：8 项无空；成功判据可写测试用例。 - 【完整模式】多假设起草（极简/结构/意识流三版，差异在结构）。
判据：三版差异在结构而非措辞。 - 【完整模式】对抗质询（自辩论 ≥2 轮，≥1 版被实质修改）。
判据：攻防记录有实质修改，否则重做。 - 【完整模式】收敛成型 + 对称性检验（镜片5）+ 三段式落点（镜片6）。
判据：能说"这版为什么赢"；每条强规则配例外。 - 【快速模式】套 PCTF 直出：目的/输入/输出/约束/兜底 五段，约束可观察。
判据：五段齐全；约束可写 if 判断。 - 注入表达层并验证迭代（S6）。按
style-dna.md重写；n≥5 实测；失败回第 3 步。
判据：5 类输入有记录；脚本零 error；CHANGELOG 有条目。
Pitfalls
- frontmatter 前有空行或 BOM —— 校验直接失败
- 触发词埋在 57 字符之后 —— 时灵时不灵
- 步骤只写动作不写判据 —— 无法判断做没做完
- 语料全塞主文件 —— 每轮白烧 token
- 只写"说什么"不写"怎么想" —— 风格类技能失真
- 加新规则不删旧规则 —— 技能堆积沉渣
- 用机器绝对路径 —— 换台机器就废
- 当轮会话看不到新技能 —— 加载器会话启动初始化，属正常
- 与
skill-creator撞车 —— 简单创建走它，严格规范走本技能 - description 含英文
:未加引号 —— YAML 解析崩 - 把规则清单当 Constitution —— 列 20 条不如讲清 1 条原则
- 意识流变表演 —— 思考块只有复述没有转折，等于空白
- 自辩论走过场 —— 三版互相恭维无修改，等于没辩
- 追问成折磨 —— 超 3 轮说不清，立刻改选项卡片让用户挑
- 思考块外泄 —— 回应里出现"基于以上思考"
- 未拍板先落笔 —— 用户没拍板就产出正文，一票否决
- 分级门失效 —— 简单需求仍走完整六段式，违反双模式初衷
Verification
- 需求 7 项（快速模式 3+ 维）均已由用户点选锁定，且有拍板动作
- 规格书 8 项无空（完整模式）；快速模式五段齐全且约束可观察
name/description/ 章节顺序 / 体积 / 判据 五项全过- 无 machine-local 绝对路径；
Don't use for已写明；强规则配例外 - n≥5 实测有记录；校验脚本零 error；
CHANGELOG.md已记录 - 输出含此岸 / 转型 / 彼岸三线（完整模式），结尾标注置信度与残余风险
冲突消解优先级（共享底座）
强规则偶发冲突时，按以下顺序裁决（后者让位于前者）：
- 第一铁律（未拍板不落笔）—— 最高，任何模式不可违反
- 选项式澄清规范（2–4 候选 +「其他」+ 复述确认）—— 交互契约
- 分级门路由（快速/完整/Lite 分流）—— 路径选择
- 其他局部规则
固化约定：S1 维度统一为 7 维（快速模式只问核心 3 维，不矛盾）；
「一次一问」为默认，「分组 ≤4 问」为授权例外；thinking 协议按风险自适应降级，
非强制。任何新增强规则必须在此表登记其优先级与例外。
FAQ 与友好报错（共享底座）
- 高频疑问集中答案：
references/faq.md（12 条，含中文 name 失效回退、与 skill-creator 撞车等） - 报错自救卡：
references/friendly-errors.md（把 E0x 翻成「发生了什么 / 怎么改 / 去哪看」） - 校验器友好输出：
python3 scripts/validate_skill.py <path> --friendly（人话版，规划中）
诚实边界
- 思考协议源自开源
Thinking-Claudev5.1-extensive（MIT），取其结构与防表演化补丁，
未照搬三千字原文；作者已于 2026-04 归档该项目。 - 不复刻 hermes 运行时行为（curator、
SKILL_HISTORY.md、hub 同步）。 - 60/57 字符来自 hermes 索引实现，WorkBuddy 未公开同一限制；采用是为优化触发精度与常驻开销。
- 视角基于认知框架技能（v2.0 蒸馏，冻结只读）。
- 内部思考不可审计：只能靠反例与置信度做间接约束，是质量提示而非质量保证。
- Lite 版（
prompt-clarify-lite）为本技能的轻量子集，共享触发路由/选项卡片/FAQ/友好报错。
改动它时，请同样跑一遍 validate_skill.py。
