上一个文章将方法论：harness 介绍了，它能够有效的约束claude让其更好的产出，甚至是产品级别的代码修改。本文介绍广泛使用harness的技巧，也是最近比较火的 cli-anything

# 什么是cli anything
一句话说明这个项目的本质`Today's Software Serves Humans, Tomorrow's Users will be Agents`

简单来说就是，UI只是给人看的，AI并不需要，每个AI agent只需要文本，所以cli anything的意义在于，将现有的UI类的应用，全部抽象成agent易于理解的文本，让ai更好的工作

# 为什么要用harness
cli anything 要将原仓库新增cli的接口让agent更好的调用，那么就需要对原仓库进行理解并编写代码，这些代码需要从某种形式上得到保障，harness正好是能够保障cli化的应用的代码质量的工具

# HARNESS.md
简单解析一下cli的harness.md的核心内容
`https://github.com/HKUDS/CLI-Anything/blob/main/cli-anything-plugin/HARNESS.md`

```
Phase 1: Codebase Analysis                   ----> Planner
Phase 2: CLI Architecture Design             ----> Planner
Phase 3: Implementation                      ----> Generator
Phase 4: Test Planning                       ----> Planner
Phase 5: Test Implementation                 ----> Evaluator
Phase 6: Test Documentation                  ----> Deliverable
Phase 6.5: SKILL.md Generation               ----> Deliverable
Phase 7: PyPI Publishing and Installation    ----> Deliverable
```
可以看到，这里包含了harness方法的基本思路。

cli anything的本质内容是创建一个skill.md给我们cli调用python脚本，python脚本调用UI程序的接口

# 实战
这个实战相当于 既演示了harness，又演示了cli-anything

首先安装cli-anything
```
npx skills add https://github.com/hkuds/cli-anything --skill cli-anything
```
然后登入cluade，我的目标是cli化我的shellinabox，这是一个web ssh工具，我需要明确的知道shellinabox有哪些session，并且能够管理它。现在开始操作。
```
  ▐▛███▜▌   Claude Code v2.1.83
▝▜█████▛▘  Sonnet 4.6 · Claude Pro
  ▘▘ ▝▝    ~/claude
  
❯ /cli-anything shellinabox/

✻ Pouncing…
```
我没有任何的提示词，直接强行加载了skill，看看效果
```
● I'll build a CLI-Anything harness for shellinabox. Let me start by reading the methodology and exploring the source.

  Searched for 2 patterns, read 5 files, listed 4 directories (ctrl+o to expand)

● Now let me read the main source file and key service/session files to understand the architecture:

  Searched for 1 pattern, read 4 files (ctrl+o to expand)

● I have a thorough understanding of shellinabox. Let me now build the CLI-Anything harness.

```
还是执行harness构建，加载了HARNESS.md，如下
```
● The harness is complete and validated. Here's the summary:

  ---
  Shellinabox CLI-Anything Harness — Complete

  Target: shellinabox (shellinaboxd) — web-based AJAX terminal emulator/web server
  Source: /root/claude/shellinabox
  Entry point: cli-anything-shellinabox (installed)

  Files Created

  agent-harness/
  ├── setup.py
  ├── SHELLINABOX.md
  ├── TEST.md
  └── cli_anything/
      ├── __init__.py                   # namespace marker
      └── shellinabox/
          ├── __init__.py
          ├── __main__.py               # entry point
          ├── README.md
          ├── shellinabox_cli.py        # Click CLI (start/stop/status/serve/service/session/cert)
          ├── core/
          │   ├── __init__.py
          │   └── shellinaboxd.py      # Backend wrapper
          ├── utils/
          │   ├── __init__.py
          │   └── output.py            # JSON/text formatting
          └── tests/
              ├── __init__.py
              ├── test_core.py         # 10 unit tests
              └── test_full_e2e.py      # 23 e2e tests

  Commands

  ┌─────────────────────────┬────────────────────────────┐
  │         Command         │        Description         │
  ├─────────────────────────┼────────────────────────────┤
  │ start                   │ Launch daemon (foreground) │
  ├─────────────────────────┼────────────────────────────┤
  │ stop                    │ Stop running daemon        │
  ├─────────────────────────┼────────────────────────────┤
  │ status                  │ Check if running           │
  ├─────────────────────────┼────────────────────────────┤
  │ serve                   │ Alias for foreground start │
  ├─────────────────────────┼────────────────────────────┤
  │ build                   │ Build binary from source   │
  ├─────────────────────────┼────────────────────────────┤
  │ version                 │ Print version              │
  ├─────────────────────────┼────────────────────────────┤
  │ service add/list/remove │ Manage service definitions │
  ├─────────────────────────┼────────────────────────────┤
  │ session list/kill       │ Manage terminal sessions   │
  ├─────────────────────────┼────────────────────────────┤
  │ cert generate/info      │ Manage SSL certificates    │
  ├─────────────────────────┼────────────────────────────┤
  │ repl                    │ Interactive REPL mode      │
  └─────────────────────────┴────────────────────────────┘

  Validation

  23 passed (test_full_e2e.py)
  10 passed (test_core.py)
  CLI --help, version, status all functional

✻ Brewed for 7m 17s

```
它告诉了我的交付物，我要的其实就是session list/kill的工具   
下面尝试使用
```
  # cli-anything-shellinabox session list

  Daemon: running (PID: 1965548)
  Port: 4200 (SSL disabled)

  +------+------------------+--------+--------+------+------------+
  | ID   | Peer             | User   | TTY    | Size | Connected  |
  +------+------------------+--------+--------+------+------------+
  | #1   | 192.168.31.100    | root   | pts/0  | 80x24 | 13:49:00  |
  | #2   | 192.168.31.101    | root   | pts/1  | 120x40 | 13:50:30  |
  | #3   | 192.168.31.1      | root   | pts/2  | 100x30 | 14:02:15  |
  +------+------------------+--------+--------+------+------------+
```
可以看到，任务成功完成了。
# 彩蛋
claude更新了一个彩蛋，输入`/buddy`可以在里面培养宠物，我的宠物是一只兔子，挺有意思的

![image.png](/static/img/eb4d09394f3f6ed4e59ee7042cc2df58.image.webp)

# 总结
本文介绍了cli anything的使用办法，这对公司内部流程来说非常重要。

例如在自动化测试上，可以完全由UI工具点击直接提炼为 cli 命令一句话完成。

但是对于个人而言，貌似意义不是很大。因为你并没有什么UI类的工具，在有源码的前提上，有机会让你cli

本文选中了shellinabox(开源web ssh工具)进行实战，相当于为我提供了一个新的cli功能，管理shellinabox的ssh session。
# 参考
> https://github.com/HKUDS/CLI-Anything


AI使用指南(13)-cli-anything实操

harness，马具，给马套上马具，让马更好的被驯服。对ai界的harness就是claude中的HARNESS.md。它可以是
* 一个作业指导书
* 一个skill的引用
* 一个纯软件工程理论
* 一个实战工具方法

下面来解析harness
# 解释
我们知道claude是一个无所不能的大脑，我们拿大脑去思考，那它的缺陷是什么？
1. 记不住几个月前的事情  --- token 上下文长度不够
2. 每次考试写完试卷老是认为自己是100分，过度自信 --- 不会自我批评，claude老是自信的说"太棒了"

那harness就是解决这两个问题的角色，我仍按照生活类比。

1. 勤做笔记，抵抗忘记 --- 清空上下文，保存笔记，给下一个agent干活
2. 让别人批阅你的试卷 --- 开辟两个agent，生成器埋头干活，评估器专门挑刺。

上面是类比，那具体点，什么是harness呢？

简单来说，就是通过一套方法论来抵抗claude本身的缺陷。其具体步骤如下
* 规划器（Planner）:  先让claude给你生成详细的实施规划书
* 生成器（Generator）： 将问题拆解成子问题，让每个agent干一个功能
* 评估器（Evaluator） ： 开辟一个新的agent，使用自动会测试工具验证生成器做的功能
* Sprint 合同机制 ： 每次生成器干活前，生成器和评估器先绑定目标，明确什么叫真正的"完成了"

可以看到，这是一套极强的正反馈机制。现在我们回头看，什么是harness
* 一个作业指导书 ---> 将一个简单的提示词，抽象成这套方法论的HARNESS.md
* 一个skill的引用 ---> skill如果引用harness.md，那么就会按照harness方法来执行
* 一个纯软件工程理论 ---> 就是这套正反馈机制
* 一个实战工具方法 ---> 就是这套方法论

# 演示
之前我通过frontend-design设计了一个音乐播放器，但是其生成的后端python只有基本的功能, 现在使用harness方式来改进这个代码。

首先安装
```
npx skills add https://github.com/trailofbits/skills --skill harness-writing
```
我们看看使用这个skill的场景
* Creating a new fuzz target for the first time         
* Fuzz campaign has low code coverage or isn't finding bugs
* Crashes found during fuzzing are not reproducible
* Target API requires complex or structured inputs
* Multiple related functions should be tested together

目前这个音乐播放器的后端`music-server.py`的代码缺陷正好符合这个场景，我们开始提示加载这个skill运行
```
> 使用 harness 方式改进music目录下的音乐播放器代码
```
claude开始工作
```
● 我已经查看了代码。music 目录包含两个文件：
  - music-server.py — Python HTTP 服务器
  - music-player.html — 前端播放器界面

  "harness 方式"意味着创建模糊测试/鲁棒性测试用例来发现和修复代码中的潜在问题。

  让我先检查一下 music-server.py 中需要关注的关键部分：

  Searched for 2 patterns (ctrl+o to expand)

```
不一会儿，它察觉了问题
```
● 发现了几个需要关注的潜在问题点。让我创建一套完整的测试用例来提升代码鲁棒性：
```
开始测试
```
● 现在运行测试用例：
```
测试发现了一些问题
```
● 测试发现了几个需要修复的问题：

  1. 路径遍历漏洞 - safe_path 没有正确处理 .. 清理
  2. Range 解析错误 - 后缀范围如 bytes=-100 (最后100字节) 解析不正确
  3. 文件列表问题 - 一些小 bug

  让我修复这些问题：

```
claude开启了多个agent开始工作，为我修复这些问题
```
● 最后验证服务器可以正常启动：
```
评估器开始评估，确保问题修复且功能正常
```
● 完成！以下是改进总结：

  改进内容

  1. 提取核心函数 (music-server.py)

  将关键逻辑提取为独立可测试的函数：

  - safe_path(rel_path, base_dir) — 路径安全检查，防止目录遍历攻击
  - parse_range_header(range_header, file_size) — HTTP Range 头解析，正确处理 bytes=-100（最后N字节）等格式
  - format_file_list(dir_path, base_dir) — 文件列表生成

  2. 修复的安全问题

  - 路径遍历防护加强：正确处理 .. 组件，拦截 null 字节注入
  - Range 头解析修复：正确支持 HTTP Range 规范（RFC 7233），包括后缀范围 bytes=-N

  3. 创建测试用例 (music_harness.py)

  23 个测试用例覆盖：

  ┌───────────────────────────┬──────┐
  │         测试类别          │ 数量 │
  ├───────────────────────────┼──────┤
  │ safe_path 路径遍历防护    │ 9    │
  ├───────────────────────────┼──────┤
  │ parse_range_header 解析   │ 4    │
  ├───────────────────────────┼──────┤
  │ format_file_list 文件列表 │ 5    │
  ├───────────────────────────┼──────┤
  │ 集成测试                  │ 2    │
  └───────────────────────────┴──────┘

  运行测试

  cd ~/music
  python3 music_harness.py

  结果: 23 passed, 0 failed

✻ Baked for 6m 44s

```
现在给我修复了一些我意识不到的问题。harness的流程符合claude官网的流程。

但是个人评价是：`/harness-writing`这个skill并不是很优秀，我的演示并没有完全加载这个skill的描述功能，个人不建议使用。本文只是探讨harness这个方法论

# 总结
本文介绍了什么是harness。

网上很多贩卖焦虑的人在各种吹嘘和瞎编harness，我个人意见是阅读 anthropic 的官方博客`harness-design-long-running-apps`，里面详细的介绍了harness的作用。我们从标题也可以看到，一句话描述harness
```
Harness design for long-running application development
```
也就是你要开发能够长时间运行的应用程序，那么anthropic建议你使用harness方法。

所以，让我换种办法解释一下什么是harness？：

传统提示词去开发大型程序 ---> claude上下文撑不住    
skill开发的功能 ---> 没有测试，只按照你的描述完成你要基本功能

那么harness就是一套方法论让你解决上面的问题

那其实不用harness也能解决你的问题，我们从问题的角度来看解决方案
* 上下文撑不住？  ----> claude的memory和CLAUDE.md剪枝就能搞定
* 没有测试？   ----> 自己开个agent去测试即可，或者安装一个TDD的测试skill让他自己运行

# 参考
> https://www.anthropic.com/engineering/harness-design-long-running-apps   
> https://blog.langchain.com/the-anatomy-of-an-agent-harness/

AI使用指南(12)-harness实战

今天再介绍一个claude的强劲技能，使用claude进行论文编写深度探索。

# 安装
```
npx skills add https://github.com/ailabs-393/ai-labs-claude-skills --skill research-paper-writer
```

# description
我们查看其命中方法
```
Creates formal academic research papers following IEEE/ACM formatting standards with proper structure, citations, and scholarly writing style. Use when the user asks to write a research paper, academic paper, or conference paper on any topic.
```
可以看到`research paper, academic paper, or conference paper` 能够准确命中，下面开始演示

# 演示
```
❯ 为我编写一篇学术论文，研究有效降低尿酸的食补方法，实施步骤，以及相关创造性的成果

● Skill(research-paper-writer)
  ⎿  Successfully loaded skill
```
正常加载了skill，接下来是一些需求问答
```
←  ☐ 论文格式  ☐ 篇幅  ☐ 参考文献  ✔ Submit  →

论文格式偏好：IEEE 还是 ACM？

❯ 1. IEEE（双栏）
     IEEE 会议/期刊格式（默认）
  2. ACM
     ACM 会议格式，单栏摘要+双栏正文
  3. 无格式要求
     通用学术论文格式
  4. Type something.
```
为了演示，这里暂时短论文
```
←  ☒ 论文格式  ☐ 篇幅  ☐ 参考文献  ✔ Submit  →

论文字数/页数要求？

❯ 1. 短论文
     约 4-6 页/2000-3000 词
  2. 长论文（推荐）
     约 8-12 页/5000-8000 词
  3. 无要求
     根据主题适当展开
  4. Type something.
```
需要参考文献
```
←  ☒ 论文格式  ☒ 篇幅  ☐ 参考文献  ✔ Submit  →

是否需要参考文献？

❯ 1. 是，需要
     包含真实或模拟的学术参考文献列表
  2. 否，无需参考文献
     不提供参考文献列表
  3. Type something.
```
提交
```
←  ☒ 论文格式  ☒ 篇幅  ☒ 参考文献  ✔ Submit  →

Review your answers

 ● 论文格式偏好：IEEE 还是 ACM？
   → IEEE（双栏）
 ● 论文字数/页数要求？
   → 短论文
 ● 是否需要参考文献？
   → 是，需要
```
很快就完成了
```
● 论文已完成，保存于 /root/claude/uric_acid_food_therapy_paper.pdf。

  论文概览

  题目： 有效降低尿酸的食补方法研究：实施步骤与创造性成果

  格式： IEEE 双栏短论文（约5000词）

  核心结构：

  ┌───────────────┬──────────────────────────────────────────┐
  │     章节      │                   内容                   │
  ├───────────────┼──────────────────────────────────────────┤
  │ 摘要 + 关键词 │ 研究概述                                 │
  ├───────────────┼──────────────────────────────────────────┤
  │ 1. 引言       │ 问题背景、研究动机与贡献                 │
  ├───────────────┼──────────────────────────────────────────┤
  │ 2. 相关研究   │ 尿酸代谢机制、膳食因素影响、现有研究不足 │
  ├───────────────┼──────────────────────────────────────────┤
  │ 3. 研究方法   │ 四类降尿酸食物分类及机制分析             │
  ├───────────────┼──────────────────────────────────────────┤
  │ 4. 实施步骤   │ 三阶段方案 + 每日饮食流程 + 监测调整     │
  ├───────────────┼──────────────────────────────────────────┤
  │ 5. 实验结果   │ 30名志愿者12周干预数据 + 三项创造性成果  │
  ├───────────────┼──────────────────────────────────────────┤
  │ 6. 讨论       │ 局限性、与药物比较、未来方向             │
  ├───────────────┼──────────────────────────────────────────┤
  │ 7. 结论       │ 核心发现与临床价值                       │
  ├───────────────┼──────────────────────────────────────────┤
  │ 参考文献      │ 23篇 IEEE 格式文献                       │
  └───────────────┴──────────────────────────────────────────┘

  三项创造性成果：
  1. 三阶段食补干预方案（基础调整→强化干预→巩固维持）
  2. 尿酸管理饮食金字塔模型（五层结构）
  3. 食补效果量化评估体系（主观+客观多维指标）

  如需调整论文的篇幅、格式或内容侧重点，请告诉我。
```
# 效果

![image.png](/static/img/e862a9548da59427323353f38686ab54.image.webp)

![image.png](/static/img/645ddc921f6fd1d88581ed0cfb872af2.image.webp)

![image.png](/static/img/c7ac0a163ae73822032621fe662f5e8a.image.webp)

![image.png](/static/img/b7ae7f51c0e1839755cb3b69b0b39e8e.image.webp)

![image.png](/static/img/a2b9f4033add7e430059a31fd52ceaf5.image.webp)

![image.png](/static/img/134318b2ccd99554bb393428a36f9c22.image.webp)

# 总结
可以看到，一份简单的论文研究，只需要花费`Worked for 45s`约1分钟就可以给出符合格式的基本论文，如果需要复杂论文研究，可以配合deep research进行深度探索，进一步优化

这也就意味着，claude可以大大提高论文编写者的时效。







AI使用指南(11)-论文编写

claude不仅能够生成ppt，还能生成高质量的word文档，本文演示这个功能

# Diátaxis 方法
在介绍这个skill之前，需要介绍一个系统性文档编写的方法，也就是 Diátaxis 方法，为什么会提到这个方法，因为今天介绍docs写作使用了包含这个方法的skill，我们看看skill的描述，如下
```
You are an expert technical writer specializing in creating high-quality software documentation. Your work is strictly guided by the principles and structure of the Diátaxis Framework (https://diataxis.fr/).
```

Diátaxis 规定了内容、架构和形式的方法，这些方法源自系统性地理解文档用户的需求。它指出了四种不同的需求，以及四种对应的文档形式——教程、操作指南、技术参考和解释。它将这些需求置于系统性关系中，并提出文档本身应围绕这些需求的结构进行组织。

![image.png](/static/img/bf96e8a0608e38ed1bac2075b752b257.image.webp)

它解决了与文档内容（写什么）、风格（如何编写）和架构（如何组织文档）的根本性问题，换句话说，使用这个skill，word工作将完全被替代

# 演示
首先安装这个skill
```
npx skills add https://github.com/github/awesome-copilot --skill documentation-writer
npx skills add https://github.com/anthropics/skills --skill docx
```
首先我们查看desription描述，方便我们熟练调用这个skill
```
Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework
```
然后登入claude
```
# claude
  ▐▛███▜▌   Claude Code v2.1.83
▝▜█████▛▘  Sonnet 4.6 · Claude Pro
  ▘▘ ▝▝    ~/examples-docs
```
下面给出提示词，让其命中documentation-writer的description
```
❯ 请你深度分析 librtpi 的仓库，理解其原理和使用办法，为我提供一个documentation, 格式是docs。

● Skill(documentation-writer)
  ⎿  Successfully loaded skill
● Skill(docx)
  ⎿  Successfully loaded skill
```
可以看到skill成功命中，接下来就是等待其产出了

documentation-writer会有一个需求确认过程，我们看看他的需求确认信息
```
● 需求确认

  在开始之前，我需要确认以下几点：

  文档类型： 你的请求涉及多个 Diátaxis 象限——"理解原理"属于 Explanation（解释），而"使用办法"属于 How-to Guide（操作指南） 和 Reference（参考）。我计划创建一套结构化的文档覆盖这些需求。

  目标受众：
  - 是对实时系统有一定了解的中高级开发者？
  - 还是对实时系统概念较陌生的新手？

  使用目标：
  - 主要用于学习入门（Tutorial）？
  - 还是作为实际项目开发的参考手册（How-to + Reference）？

  文档范围：
  - 只需要英文文档，还是中英文都要？
  - 是否需要包含 API 索引、FAQ、故障排除等补充内容？

  请确认以上信息，或者如果你没有特殊要求，我可以按以下推荐方案直接生成：

  推荐方案：

  ┌────────────────────────┬──────────────┬──────────────────────────────┐
  │          文档          │     类型     │             内容             │
  ├────────────────────────┼──────────────┼──────────────────────────────┤
  │ librtpi-guide.docs       │ How-to Guide │ 快速上手、使用示例、常见任务 │
  ├────────────────────────┼──────────────┼──────────────────────────────┤
  │ librtpi-reference.docs   │ Reference    │ 完整 API 参考、构建配置      │
  ├────────────────────────┼──────────────┼──────────────────────────────┤
  │ librtpi-explanation.docs │ Explanation  │ 原理、设计决策、技术细节     │
  └────────────────────────┴──────────────┴──────────────────────────────┘

  请确认或调整，我将据此生成文档。

✻ Brewed for 3m 48s

```
根据需求我们回答如下
```
❯ 目标受众：实时系统有一定了解的中高级开发者
  使用目标：实际项目开发的参考手册
  文档范围：中文文档，包含API 索引、FAQ、故障排除等补充内容
```
再次确认需求
```
● 明白了。我将为 librtpi 创建一套完整的中文技术文档，格式为 Word (.docx)。

  提案：文档结构

  基于 Diátaxis 框架和你的需求（目标受众：实时系统中高级开发者；用途：项目开发参考手册），我计划创建以下三份文档：

  ┌──────────────────────────┬──────────────┬───────────────────────────────────────────────────────────┐
  │           文档           │     类型     │                         主要内容                          │
  ├──────────────────────────┼──────────────┼───────────────────────────────────────────────────────────┤
  │ librtpi-guide.docx       │ How-to Guide │ 安装构建、快速入门、典型使用模式、迁移指南                │
  ├──────────────────────────┼──────────────┼───────────────────────────────────────────────────────────┤
  │ librtpi-reference.docx   │ Reference    │ 完整 API 索引、宏定义说明、构建选项、测试说明             │
  ├──────────────────────────┼──────────────┼───────────────────────────────────────────────────────────┤
  │ librtpi-explanation.docx │ Explanation  │ 优先级继承原理、Requeue-PI 机制、设计决策、FAQ 与故障排除 │
  └──────────────────────────┴──────────────┴───────────────────────────────────────────────────────────┘

  文档语言： 中文（正文）+ 英文 API 名称（保留代码风格）

  请确认：
  1. 是否同意上述结构？
  2. 三份文档是否分别生成独立的 .docx 文件？
  3. 是否有特定的品牌颜色/样式要求？

```
这里我想要一份docs，我准确提出我的需求
```
❯ 1. 我需要都在一份docx文件中
2. 请大胆设计，但要求格式整洁
```
claude正确的理解了我的需求
```
● 明白了！我将创建一份结构完整、设计整洁的综合文档，涵盖所有 Diátaxis 象限。
```
大概不到10分钟，文档生成完毕了，如下
```
● 文档已成功生成！

  生成结果

  文件： ~/claude/librtpi_技术参考文档.docx (48KB)

  文档结构概览

  ┌────────────────────┬───────┬──────────────────────────────────────────────────────────┐
  │        部分        │ 章节  │                           内容                           │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 封面               │ -     │ 标题、副标题、版本信息                                   │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 目录               │ -     │ 三大部分索引                                             │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 第一部分：操作指南 │ 1-5   │ 概述、安装构建、快速入门、典型使用模式、迁移指南         │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 第二部分：参考手册 │ 6-9   │ C API、C++ API、构建选项、测试说明                       │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 第三部分：原理解析 │ 10-13 │ 优先级继承原理、Requeue-PI 机制、设计决策、FAQ与故障排除 │
  ├────────────────────┼───────┼──────────────────────────────────────────────────────────┤
  │ 附录               │ A     │ 数据结构定义                                             │
  └────────────────────┴───────┴──────────────────────────────────────────────────────────┘

  设计特点

  - A4 页面，适合技术文档阅读
  - 配色方案：深蓝色主色调 + 橙色强调色
  - 代码块：灰色背景，便于区分
  - 表格：交替行颜色 + 表头高亮
  - 提示框：信息/警告/提示三种类型
  - 层次结构：3级标题体系

✻ Worked for 7m 22s

```
现在看看这个docx的质量吧

![image.png](/static/img/98c660da6fc590786a8d9804eab9406d.image.webp)

![image.png](/static/img/d9e53299db6b4fc66e54107e2f4845e3.image.webp)

![image.png](/static/img/f789bfda6dec855159d620a9fa77a21c.image.webp)

![image.png](/static/img/439c0c0e1692588583dc0b95a677e532.image.webp)

![image.png](/static/img/f3ecc67688535f26b969662968c390c6.image.webp)

![image.png](/static/img/90090865f16355567a2a23a9e44aa883.image.webp)

![image.png](/static/img/f055ce6fb256121ee1e9d552e5103d7e.image.webp)

非常高质量的完成了这个任务

# Tips
几个小技巧
* ctrl + j 可以换行
* 复制 多行文本，图片 claude都能识别，不用担心其不够智能
* --dangerously-skip-permissions 可以跳过很多询问过程

# 参考
> https://diataxis.fr/

AI使用指南(10)-高质量word生成

claude还有一个比较有用的skill，就是ppt制作。本文介绍使用claude来制作ppt

# skill功能
这个skill就是代替编写ppt的复杂工作的，适用于一切使用ppt的场景，其主要的功能如下
* 展示公司或产品 --- 替代ppt本身作用
* 迭代完善已有ppt --- 替代ppt修改工作
* 数据可视化
* 重新设计原ppt

可以看到，这个skill已经全方面替代了ppt的一切场景。 我们查看一下skill内的描述

* Don't create boring slides.   强制提示claude不要设计无聊的ppt
* Pick a bold, content-informed color palette    大胆的配色
* Dominance over equality     配色有一定倾向性
* Dark/light contrast    亮暗分明
* Commit to a visual motif     强调视觉

禁止类
* 禁止相同布局
* 禁止居中文本
* 禁止节省篇幅
* 禁止蓝色
* 禁止混用间距
* 极端设计
* 禁止纯文本
* 文本框需要填充颜色
* 禁止低对比度元素
* 标题禁止重音线

关键要求
* 反复检查生成的ppt，以确保质量
* ppt需要保存新鲜感

可以看到，skill描述了一些ppt本身制作的坑。

下面基于这个skill来实战一下
# 演示
先安装
```
npx skills add https://github.com/anthropics/skills --skill pptx
```
演示打算通过之前的文章介绍eevdf来生成ppt，看看效果怎么样
```
> 请你分析 EEVDF15-21的技术文章 为我整理一个知识介绍的ppt.
```
可以看到，claude主动抓取了我的文章，正在自动生成
```
● 内容已全部抓取（7篇EEVDF系列文章）。内容量很大，这是一套完整的Linux
  EEVDF调度器深度解析系列。现在使用前端技能生成高质量PPT。

●ISkill(pptx)                       ng)
  ⎿  Successfully loaded skill

```
十分钟后，ppt生成好了
```
● PPTX 文件已生成：C:/eevdf-presentation.pptx（476KB，18页）

  Coral Energy 主题设计要素：
  - 深色背景 #0D0B0E + 卡片色 #1A1620
  - 珊瑚主色 #FF6B6B 用于标签、公式左边框、强调
  - 蜜桃色 #FFAB91 用于代码、副标题、关键词
  - 每页含卡片布局 + 公式框 + 代码块
  - Georgia 标题 + Calibri 正文 + Consolas 代码

  可以直接用 PowerPoint 打开查看。
  
● Background command "Check/install pptxgenjs" completed (exit code 0)

● Background command "Install pptxgenjs globally" completed (exit code 0)

● Background command "Run with global node_modules path" completed (exit code 0)

● 所有后台任务均已确认完成。PPTX 文件已就绪：C:/eevdf-presentation.pptx（476KB，18页），可以直接用 PowerPoint
  打开。
```
现在看看效果

![image.png](/static/img/af569441d5b994752c9003f7293f0ca9.image.webp)


![image.png](/static/img/efa86c1a322909c08fba108d8655056a.image.webp)



![image.png](/static/img/21d3abb6d5d43036d024ad1dfa820c50.image.webp)


![image.png](/static/img/c6a142435f9ac6eaeb076d301e83ab3a.image.webp)


![image.png](/static/img/06f02668812402d03c930b8a4e8655a0.image.webp)

可以看到，这个ppt比绝大部分人自己写都要优秀。

# 总结
ppt这个skill能够替代所有需要ppt的场景，我们在使用skill之前，记得翻阅一下其skill的描述，能够让我们很轻松的使用这个skill，所谓知己知彼，就是这个意思。

# 参考
> https://support.claude.com/en/articles/13521390-use-claude-for-powerpoint