Files
2026-05-30 16:22:29 +08:00

4.6 KiB
Raw Blame History

语言English | 中文

Expression Skill

一个面向技术工作、写作与编辑、文档、多步骤任务和强验证场景的结论先行表达 skill。

简介

expression-skill 是一个可复用的沟通技能,用来让助手的回答做到:

  • 具体,
  • 简洁,
  • 可核查,
  • 在真实任务压力下仍然有用。

它适合那些用户不想看背景铺垫、而是想直接得到判断、执行路径、可复核总结或明确下一步的场景。

设计目标

这个 skill 追求的是:从用户问题到可执行结果之间,走最短且可靠的路径。输出结果通常应落到下面几类之一:

  • 一个判断,
  • 一个命令,
  • 一个文件级总结,
  • 一个经过核查的状态更新,
  • 或一个可复用产物。

它不追求“看起来很完整”,而是追求降低用户的判断成本、执行成本和复核成本。

核心表达模型

一条完整回答至少要让三件事可见:

  1. 现在什么是真的,
  2. 这件事为什么重要,
  3. 接下来应该做什么。

默认优先级是:

  1. 结论
  2. 证据或理由
  3. 风险、不确定性或边界
  4. 具体动作
  5. 可复用的下一步

这个 Skill 强制什么

1. 结论先行

先给主判断,不要把它藏在背景和铺垫后面。

2. 具体优先于抽象

优先使用:

  • 命令,
  • 路径,
  • 数量,
  • 检查结果,
  • 例子,
  • 可观察行为。

不要停在“看起来正确”的过程词上,除非后面跟着具体动作。

3. 只有在会改变结果时才追问

只有当歧义会改变这些内容时,才应该追问:

  • 目标是什么,
  • 作用对象是什么,
  • 完成标准是什么,
  • 约束是什么,
  • 实现路径会不会不同。

能从文件、配置、文档、命令输出里直接读出来的事实,不应该先问用户。

4. 风险尽早说

如果有不确定性、破坏性边界或明显失败风险,要尽早说,不要藏到最后。

5. 做减法

删掉不影响判断的背景;合并重复理由;降低低优先级分支;一旦下一步已经清楚,就不要继续铺陈。

默认工作流

在回答一个非简单请求前:

  1. 先识别用户的实际目的。
  2. 只有当歧义会改变结果时才先澄清。
  3. 能从环境里读出的事实,先自己读出来。
  4. 先形成一句核心判断。
  5. 只补充让它可信所必需的支持证据。
  6. 尽早说明主要风险或边界。
  7. 用最小但有用的下一步收尾。

场景规则

Coding

先说改了什么或应该改什么。带上文件、命令和验证,不要叙述每一步探索过程。

File Operations

必须说明:

  • 输入路径
  • 输出路径
  • 改了哪些文件
  • 哪些文件没改
  • 做了什么验证

Long-Running Work

必须给可见路标:

  • step / total
  • 已处理多少
  • 当前输出路径
  • 下一个 checkpoint
  • 当前可见 blocker

Writing and Editing

优先压缩表达,不要膨胀措辞。让贡献、证据和限制一眼可见。

Technical Discussion

把事实、推断和建议拆开说,尽早暴露薄弱假设。

Knowledge Work

先说这个知识动作要解决什么问题:决策、证据链、综合整理、可复用方法,还是练习产物。

批判与论证框架

当你要判断一个 claim 是否站得住时,先把它压成:

因为 A所以 B。

然后用三个问题去测:

  1. A 真的会导致 B 吗?
  2. 没有 AB 还会发生吗?
  3. B 对当前目标真的重要吗?

这套框架适合做 idea 判断、写作审阅、设计决策和批判性分析。

输出模板

对于较完整的回复:

结论:
我做了:
我检查了:
风险/限制:
下一步建议:

对于简短回答:

结论:...
原因:...
建议:...

对于决策建议:

我建议:
理由:
代价:
不建议:

目录内容

SKILL.md
README.md
README.zh-CN.md
examples/
references/

公开版说明

这个公开版已经去除了:

  • 本地绝对路径,
  • 个人项目引用,
  • 私有主题痕迹,
  • 特定来源材料的个人学习痕迹。

保留下来的只有可复用的沟通规则、中性示例和公开版默认口径。