soia-pkm-publish-wechat-draftlisted
Install: claude install-skill soia-team/soia-open-skills
# soia-pkm-publish-wechat-draft
PKM 闭环的**公众号发布环节(发)**:把 `compose` 产出的成文草稿排版、校验,并在确认后推入微信公众号草稿箱。
> 蓝本:vault 里一篇关于 Obsidian + AI 公众号排版工作流的归档文章——本 skill 是它的落地实现;不要在公开 skill 中写入个人 vault 的真实路径。
## 客户可读说明
### 这个技能可以做什么
把写好的文章草稿排版成遵守微信公众号限制的内联样式 HTML,机械校验通过后调用微信 `draft/add` API 推到草稿箱。这个技能只建草稿,绝不自动群发。
| 客户想要 | 技能会做 | 客户能看到 |
|---|---|---|
| 完成本技能覆盖的工作 | 读取用户请求、必要上下文和本技能正文流程,执行最小可靠步骤 | 客户会看到 Obsidian/vault 文件变更、终端日志、生成产物路径和最终回执。 |
| 缺少依赖、权限、配置或 key | 停止需要外部状态的动作,明确指出缺什么 | 安装命令、申请地址、配置路径或需要客户确认的问题 |
| 执行完成 | 汇总成功、跳过、失败、文件变更和验证结果 | 一段可复制进工单/日志的完成回执 |
### 客户如何使用
1. 用自然语言说明目标,并提供必要输入:文件、URL、repo、workspace、proposal、vault 或平台账号状态。
2. Agent 先判断是否命中本技能,再检查依赖、配置、权限和风险动作。
3. 能 dry-run 或预览的动作先给预览;涉及删除、覆盖、发送、发布、写远端状态时先征求客户确认。
4. 执行后验证真实输出,不用“看起来成功”代替证据。
5. 最终回复必须给客户可见总结:做了什么、日志摘要、文件变化、问题和下一步。
### 依赖与安装
安装本技能(单个技能):
```bash
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-publish-wechat-draft -y
```
配置约定:
```text
~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-publish-wechat-draft/config.yml
SOIA_PKM_PUBLISH_WECHAT_DRAFT_CONFIG_FILE=<custom-config-path>
```
- 如果本技能不需要私有配置,可以不创建 `config.yml`。
- 如果需要 API key、cookie、session、provider home 或本机路径,只能放进私有 `config.yml`、进程环境或 provider 自己的登录态里,不能写进仓库、vault 正文或日志。
- 强依赖、可选依赖和第三方 skill 关系必须以本 `SKILL.md` 后续的“依赖 / 前置 / 资源 / 边界”说明为准;没有写清楚时,先补说明或询问客��,不要猜。
- 第三方 skill 只能声明依赖和安装方式,不直接修改第三方 skill 文件。
### 日志与完成回执
每次执行都要让客户看见过程和结果。最低回执格式:
```markdown
完成:<一句话说明本次完成了什么>。
日志摘要:
- started: <检查到的输入/配置/依赖,不打印秘密值>
- processed: <数量或范围