card-skill

Agent 用卡片回答,你逐张判断。

给 Claude Code 这类编程 Agent 用的技能。Agent 把回答摆成一个看板,一张卡片只说一个结论,最多带一个提问。回复是结构化数据,一张卡片一行,传回给 Agent。

这个示例可以直接操作。随便答,不会发出,也不会保存。这个示例可以直接操作。先点“6 选择”。
  1. 点橙色标签“6 选择”,打开提问。Agent 建议的选项标着“建议”,你选了才算数。
  2. 选意式咖啡机,不选建议的那个。卡片 7 是按美式滴滤机写的,所以会暂缓。
  3. 点“发送”。弹出的就是 Agent 会读到的完整回复。
  4. 再点“桌面”。同样的卡片铺在桌面上,有关联的卡片之间连着线。

同一张卡片,三种样子

3
1

Agent 写下的

示例里的卡片 6,在 board.org 里就是这几行。纯 Org mode:标题是结论,抽屉里写这张卡片要你做什么,复选框是选项。

** 选美式滴滤机,除非团队离不开意式浓缩
:PROPERTIES:
:CUSTOM_ID: pick-machine
:ASK: choose
:END:
它能应付早高峰,清洗也不超时,一年下来成本最低。团队有多想喝意式浓缩,只有你知道;买一台没人喜欢的机器,钱就白花了。

#+caption: 一年的咖啡开销,单位欧元:机器加 6,000 杯
#+begin_src chart
| 机器       | 欧元  |
|------------+-------|
| 美式滴滤机 | 1,380 |
| 意式咖啡机 | 3,480 |
| 胶囊机     | 3,000 |
#+end_src

- [X] [[#batch]]
- [ ] [[#espresso]]
- [ ] [[#capsule]]
2

你看到的

同一张卡片在页面上。标签说明它在等你。Agent 建议的选项有标记,你选了才算数。

示例的卡片 6:橙色标签“选择”,三个选项,第一个标着“建议”
3

Agent 读到的

一张卡片一行,固定用英文。这是选了意式咖啡机之后示例会发出的回复。在上面的示例里点“发送”,这里就换成你自己的回复。

#6 pick-machine choose  changed: espresso  (you suggested batch)
#7 order  approve  held: #6 changed from your suggestion; this ask was written for the suggestion. Ask again.
#3 batch  mark  more (go deeper)

卡片还能做的三件事

卡片改了会标出来,旧的说法也留着

Agent 改的是卡片,不是把回答重写一遍。卡片编号不变,版本加一,之前的版本划掉留在下面。你对旧版本的回答会被标出来,不会直接沿用。

本项目设计评审看板里的卡片 13,已经改到 v5。看板是英文的。

一张标着 v5 的卡片,下面是四个划掉的旧版本

卡片能把说的事画成图

Agent 只写谁指向谁,方框和箭头由页面来画。截图和文件里的二十行也这样放进卡片,全在同一个 HTML 文件里。

同一个看板的卡片 11:回复传回 Agent 的两条路。

一张带流程图的卡片:发送之后走服务器或者走文件,两条路都通到 Agent

一张图可以自己就是一张卡片,别的卡片钉在图上

好几张卡片都在讲同一张图时,Agent 就把这张图单独做成一张卡片:按图需要的大小画,排在它那一节的最前面。讲图里某个部分的卡片钉在那个部分上,那里会显示卡片的编号。点编号就跳到那张卡片。

上面中文示例的卡片 1:卡片 3 和 4 钉在早高峰那个钟点上。

一张每小时杯数的折线图,自己就是一张卡片;9 点的高峰上标着两台机器卡片的编号 3 和 4

可以打开的看板

4

两个是示例,中英文各一个;两个是这个项目自己在用的看板。在哪个看板上点“发送”,都只显示回复,不会发出去。

安装

# 1. 安装技能。要真的复制一份,不要做软链接。
git clone https://github.com/lroolle/card-skill
cd card-skill && make install

# 2. 不用 Agent,也能先看一个看板。
node skill/bin/cards.mjs render design-review
node skill/bin/cards.mjs serve

然后让 Agent 做一件要你拿主意的事。

比较三台咖啡机,给团队用,让我来选。用卡片回答。

技能里写了什么时候值得用看板,什么时候直接说更好。多数回答还是该用文字。

需要 Node 18 及以上,没有其他依赖。make install 会把技能复制到 ~/.claude/skills(Claude Code 用)和 ~/.agents/skills(Codex 用)。更新:git pull && make install。node ~/.claude/skills/card-skill/bin/cards.mjs --version 能看到当前版本。

它不做的事