无尘阁日记

无尘阁日记

制作skills-医药行业根因分析
2026-04-02

我已经按你这个新要求重做了一版 v3：

下载增强版技能包 ZIP
查看增强版技能包目录

这版不是简单加一句提示，而是把“行业准入闸门”正式并进了总控 skill、AGENTS.md、目录约定和日志规则里。整体分析链路仍然沿用你那份手册的四阶段框架与总控思路。

这次升级后的核心能力

1. 手动拖文件进窗口

你把 Excel 扔进对话窗口，然后说：

开始根因分析。先做医药行业识别，不是医药文件就直接拒绝；是医药文件就自动完成后续全部分析并保存报告。

系统会先做医药行业准入判断：

  • 如果判断通过：继续跑字段理解 → 异常识别 → 证据链 → 最终根因分析

  • 如果判断不通过：直接回复

不可执行，文件非医药行业。

2. 自动任务触发

如果是 cron / webhook / 扫描目录模式，先读：

inbox/root-cause/

然后先过医药行业准入闸门：

  • 通过：正常生成报告

  • 不通过：不分析，不生成报告

  • 但会把拒绝结果写进 OpenClaw 工作区日志，并登记为已拒绝，避免下次反复扫到同一个文件

我这次加进去的关键规则

行业准入规则

只有文件能明显映射成这类链路，才允许执行：

  • 药品主数据

  • 客户主数据

  • 医院终端采购

  • 商业渠道出货

  • 竞品对比

如果文件看起来是零售、人事、财务、项目管理、互联网运营等非医药内容，或者虽然是 Excel，但字段根本无法建立“药品—客户—医院—商业—竞品”的分析链路，就直接拒绝执行。

自动拒绝写日志

自动模式下，非医药文件会写到：

logs/root-cause/auto-execution.log

同时还会登记到：

reports/root-cause/rejected-manifest.jsonl

这样做有两个好处：

  • 有审计痕迹，知道为什么没跑

  • 下次 cron 不会再重复处理同一个被拒绝文件

成功处理登记

通过行业闸门并分析成功后，会写：

reports/root-cause/processed-manifest.jsonl

并落两份报告：

reports/root-cause/YYYYMMDD-HHMM-management-summary.md
reports/root-cause/YYYYMMDD-HHMM-full-report.md

你现在要替换成这版 v3

这版更适合你真实业务，因为它已经把“只允许运行医药文件”做成了硬门槛，而不是靠模型临场理解。

OpenClaw 官方文档也确实是把这几个层次分开的：

  • skills 负责教 agent “什么时候、怎么做”

  • standing orders / AGENTS.md 放长期规则，并从 workspace 启动时注入

  • cron 是 Gateway 的内置调度器

  • hooks 可以在事件触发时往 workspace 写文件或执行后续动作。(OpenClaw)

另外，workspace 本身就是 OpenClaw agent 的工作目录，AGENTS.md 和 skills/ 都适合放在这里统一管理，所以我这版把 inbox/、reports/、logs/ 也一起规范到 workspace 下面了。(OpenClaw)

这版包里多了什么

你会看到除了原来的 5 个 skills，还新增了这些文件：

  • logging-policy.md

  • 更新后的 AGENTS.md

  • 更新后的 directory-layout.md

  • 更新后的 cron-examples.md

  • 更新后的 trigger-phrases.md

以及预建目录：

  • inbox/root-cause/

  • reports/root-cause/

  • logs/root-cause/

你下一步怎么落地

先把这个 v3 包解压，把 5 个 skill 目录放进你的 OpenClaw workspace 的 skills/ 目录，再把 AGENTS.md 放到 workspace 根目录。
然后在 workspace 下保留这三个目录：

inbox/root-cause/
reports/root-cause/
logs/root-cause/


下面给你一版可直接照着做的部署步骤。我按两种环境写：Mac/Linux 和 Windows。
你这次用的是我给你的 v3 技能包：

下载增强版技能包 ZIP

这套部署方案基于 OpenClaw 官方能力边界：
skills 建议放在 workspace 下；AGENTS.md 会在每个 session 自动注入；新 skill 生效最稳的方式是开新会话或重启 gateway；cron 是 Gateway 内置调度器并持久化在本机；配置文件默认在 ~/.openclaw/openclaw.json。(OpenClaw)

一、先明确你最终会得到什么

部署完成后，你会有两种使用方式：

1. 手动模式

你把 Excel 直接拖进 OpenClaw 对话窗口，然后说：

开始根因分析。先做医药行业识别，不是医药文件就直接拒绝；是医药文件就自动完成后续全部分析并保存报告。

这时会优先处理当前会话里上传的文件；如果识别为非医药行业，就直接回复：

不可执行，文件非医药行业。

2. 自动模式

你把 Excel 丢进 workspace 里的：

inbox/root-cause/

然后 cron 定时扫描。
如果文件不属于医药分析场景，就不执行分析，同时把拒绝原因写进 OpenClaw 工作区日志。

二、先确认你的 OpenClaw 工作区路径

官方文档示例默认用的是：

~/.openclaw/workspace

skills 也推荐直接建在这个 workspace 里。(OpenClaw)

但如果你之前 setup 时改过 workspace，就以你自己的实际路径为准。
下面我先按默认路径写。

三、Mac / Linux 部署步骤

第 1 步：下载并解压技能包

把这个 zip 下载到本地，然后解压。

假设你下载到了“下载”目录：

cd ~/Downloads
unzip openclaw_root_cause_skills_v3.zip -d openclaw_root_cause_skills_v3

第 2 步：创建 OpenClaw 需要的目录

mkdir -p ~/.openclaw/workspace/skills
mkdir -p ~/.openclaw/workspace/inbox/root-cause
mkdir -p ~/.openclaw/workspace/reports/root-cause
mkdir -p ~/.openclaw/workspace/logs/root-cause

第 3 步：把 5 个 skill 目录复制进去

把解压后的 5 个 skill 文件夹复制到 workspace 的 skills/ 下。
你可以直接整包复制，也可以只复制那 5 个 skill 目录。

示例命令：

cp -R ~/Downloads/openclaw_root_cause_skills_v3/skills/* ~/.openclaw/workspace/skills/

官方说明，workspace 下的 skills/ 是标准技能加载位置之一。(OpenClaw)

第 4 步：把 AGENTS.md 放到 workspace 根目录

cp ~/Downloads/openclaw_root_cause_skills_v3/AGENTS.md ~/.openclaw/workspace/AGENTS.md

这是关键。因为官方明确说，AGENTS.md 会在每个 session 自动注入；standing orders 最推荐就写在这里。(OpenClaw)

第 5 步：可选，把说明文档也放进去

这一步不是必须，但建议做，方便你以后维护：

cp ~/Downloads/openclaw_root_cause_skills_v3/*.md ~/.openclaw/workspace/

第 6 步：让新 skills 生效

官方建议两种最稳方式：

  • 开一个新会话 /new

  • 或重启 gateway：openclaw gateway restart (OpenClaw)

你直接执行：

openclaw gateway restart

然后再检查：

openclaw skills list

官方 CLI 文档确认 skills list 就是本地可见 skills 的检查命令。(OpenClaw)

第 7 步：先做一次手动验证

把一个医药行业 Excel 拖进对话窗口，然后发这句：

开始根因分析。先做医药行业识别，不是医药文件就直接拒绝；是医药文件就自动完成后续全部分析并保存报告。

验证通过后，报告会落到：

~/.openclaw/workspace/reports/root-cause/

日志会落到：

~/.openclaw/workspace/logs/root-cause/

四、Windows 部署步骤

第 1 步：下载并解压 zip

把 zip 下载到本地，比如：

C:\Users\你的用户名\Downloads\openclaw_root_cause_skills_v3.zip

右键解压到：

C:\Users\你的用户名\Downloads\openclaw_root_cause_skills_v3

第 2 步：创建目录

在 PowerShell 里执行：

New-Item -ItemType Directory -Force "$HOME\.openclaw\workspace\skills"
New-Item -ItemType Directory -Force "$HOME\.openclaw\workspace\inbox\root-cause"
New-Item -ItemType Directory -Force "$HOME\.openclaw\workspace\reports\root-cause"
New-Item -ItemType Directory -Force "$HOME\.openclaw\workspace\logs\root-cause"

第 3 步：复制 skills

假设你解压后的目录在 Downloads：

Copy-Item "$HOME\Downloads\openclaw_root_cause_skills_v3\skills\*" "$HOME\.openclaw\workspace\skills" -Recurse -Force

第 4 步：复制 AGENTS.md

Copy-Item "$HOME\Downloads\openclaw_root_cause_skills_v3\AGENTS.md" "$HOME\.openclaw\workspace\AGENTS.md" -Force

第 5 步：重启 gateway 或开新会话

官方建议新 session 或重启 gateway 让 skill 稳定生效。(OpenClaw)

PowerShell 里执行：

openclaw gateway restart

然后检查：

openclaw skills list

五、自动执行怎么配

目录规则

自动模式只扫这个目录：

inbox/root-cause/

把待分析 Excel 放进去即可。
分析结果写到：

reports/root-cause/

拒绝执行、失败原因、运行日志写到：

logs/root-cause/

加一个定时任务

官方说明 cron 是 Gateway 内置调度器，任务会持久化保存在本机 ~/.openclaw/cron/ 下，重启也不会丢。(OpenClaw)

你可以先建一个每天早上 8:30 扫描的任务：

openclaw cron add \
  --name "Pharma Root Cause Scan" \
  --cron "30 8 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "按 AGENTS.md 中的《医药根因分析自动执行程序》执行：扫描 inbox/root-cause/ 中最新未处理 Excel；先做医药行业识别，若判定为非医药行业则拒绝执行并把原因写入 logs/root-cause/；若通过则完成完整根因分析，并把管理层摘要和完整报告写入 reports/root-cause/。" \
  --no-deliver

这里我用了 --session isolated，因为官方 cron 文档区分了 main session 和 isolated session；CLI 文档也说明 isolated 任务可以选择 --no-deliver，这样结果不往聊天通道推，只在内部执行。(OpenClaw)

查看任务是否加成功

openclaw cron list

手动触发一次 cron 试跑

openclaw cron run <job-id>

如果要跟踪执行结果，官方建议用：

openclaw cron runs --id <job-id>

因为现在 cron run 返回的是“已入队”，不是同步跑完。(OpenClaw)

六、如果你还要做“外部系统投文件后立即触发”

这时要用 webhook。
官方 webhook 文档说明，请求里可以带 message，也可以指定 agentId，并且会使用对应 agent 的 workspace 和配置。(OpenClaw)

你可以理解为：

  1. 外部程序先把 Excel 放进 inbox/root-cause/

  2. 然后调用 webhook

  3. webhook 触发 agent 按 AGENTS.md 的规则扫描和执行

但 webhook 这一步需要你在 ~/.openclaw/openclaw.json 里把 hooks 配起来；官方配置文件位置就是这里。(OpenClaw)

七、你部署完以后，最先检查这 4 件事

1. skills 是否可见

执行：

openclaw skills list

如果没看到那 5 个 skill，先别急着改文件，先执行：

openclaw gateway restart

或者开新会话。官方明确写了，新 skill 生效最稳就是这两种方式。(OpenClaw)

2. AGENTS.md 是否放对位置

必须在：

~/.openclaw/workspace/AGENTS.md

不是放在 skills/ 里面，也不是别的子目录。
因为 workspace bootstrap 自动注入的是根目录下这些固定文件，不会自动注入任意子目录文件。(OpenClaw)

3. 自动任务是否真的在扫目录

看这两个地方：

~/.openclaw/workspace/logs/root-cause/
~/.openclaw/cron/

前者是你这套方案定义的业务日志目录；后者是 OpenClaw cron 的持久化目录。(OpenClaw)

4. 非医药文件是否会被拒绝

丢一个明显非医药 Excel 去测试。
如果是手动模式，应直接回复：

不可执行，文件非医药行业。

如果是自动模式，应在：

logs/root-cause/

里看到拒绝记录。

八、最省事的落地顺序

按这个顺序最稳：

第一步

先完成 skills + AGENTS.md 部署。

第二步

先用手动拖文件跑通一次。

第三步

再开启 cron 自动扫描。

第四步

最后再接 webhook 或飞书之类外部触发。

这样排查最简单。因为一旦你一开始就把 cron、webhook、群消息全叠上，出了问题很难判断是 skill、workspace、配置还是触发链路的问题。

九、给你一版最短命令清单（Mac）

mkdir -p ~/.openclaw/workspace/skills
mkdir -p ~/.openclaw/workspace/inbox/root-cause
mkdir -p ~/.openclaw/workspace/reports/root-cause
mkdir -p ~/.openclaw/workspace/logs/root-cause

cp -R ~/Downloads/openclaw_root_cause_skills_v3/skills/* ~/.openclaw/workspace/skills/
cp ~/Downloads/openclaw_root_cause_skills_v3/AGENTS.md ~/.openclaw/workspace/AGENTS.md

openclaw gateway restart
openclaw skills list

然后直接测试手动触发。