prefer-html-output
让 agent 在合适的场景把"给人看的 markdown 长输出"改用 HTML 渲染,使内容更易消化。基于 Anthropic Claude Code 工程负责人 Thariq Shihipar 的 html-effectiveness 项目里 20 个真实示例。
何时触发本 skill(混合模式)
Agent 在每次准备输出回复时按下面三层依次判断;只在 Layer 2 命中时才打扰用户:
Layer 1 · 硬性排除(命中任一 → 静默走 markdown)
- 输出会被自动管道消费(写
.md文件、回填 PR/Issue 描述、生成 commit message、写日志等) - 用户明确要求 markdown / 纯文本
- 短回复(< ~20 行)或对话式问答
- 输出主体是源代码编辑、命令执行、调试输出
Layer 2 · 高价值场景识别(命中才进入提议环节)
查 `references/sce
[Description truncada. Veja o README completo no GitHub.]