docs(skills): 排错清单统一成「报错 → 怎么办 → 命令」,office 改为建软链

技能目录的 AGENTS.md 只在报错时被读,所以只写「报错原文 → 怎么办 → 命令」,一节一个
现象,不写背景。命令块前统一声明「仅为示例,具体以本机平台实际情况为准」——路径分隔符、
可执行名、包管理器交给模型按本机情况自愈,不逐平台列出。

office:`command not found` 从按次拼 PATH 前缀改成建一次 $HOME/.local/bin/office 软链。
每条 terminal 命令都是新 shell,前缀不跨命令生效,按次拼的写法容易被反复踩。
image-process:PIL 缺包与「中文水印缺字体」拆成两节。
x2pdf:后端代价表压成三条列表,四个现象(ModuleNotFoundError / 没有可用排版能力 /
could not import some external libraries / 排版降级)各自成节。
document-photo-to-pdf:单节化,保留 fitz 是 pymupdf 的 import 名这条坑。
data-page 只用标准库,不需要 AGENTS.md。
This commit is contained in:
2026-11-12 10:05:46 +08:00
parent 8a92f2543d
commit 25f9e157ad
4 changed files with 43 additions and 20 deletions
+10 -3
View File
@@ -1,12 +1,19 @@
# office
`office: command not found`:用技能自带入口
以下命令仅为示例,具体以本机平台实际情况为准(自行判断路径、可执行名、分隔符)。
## office: command not found
入口不在 PATH:建一次软链,之后一直能用。
```sh
PATH="$(dirname "$AGENT_SKILLS_DEPS")/office/scripts:$PATH" office help
mkdir -p "$HOME/.local/bin"
ln -sfn "$(dirname "$AGENT_SKILLS_DEPS")/office/scripts/office" "$HOME/.local/bin/office"
```
`office.core binary missing`:按本机平台下载对应资产到 `bin/officecli`(Windows 存成 `bin/officecli.exe`),再 `chmod +x`
## office.core binary missing
按本机平台下载对应资产到 `bin/officecli`(Windows 存成 `bin/officecli.exe`),再 `chmod +x`。
```sh
SK="$(dirname "$AGENT_SKILLS_DEPS")/office"