SuperAPI AI 工具集

soia-pkm-compose

通用与其它

查看项目

更新于 10-16 08:09

技能介绍

soia-pkm-compose 是 PKM 闭环中“写”的环节,位于 clip(收)→ organize(整理)→ distill(点)→ compose(写)→ publish(发)之间。上游 distill 提供观点,本技能将其写成成文草稿,下游 publish 再做多平台适配。

用途:把 distill 提炼出的观点写成一篇可发布文章草稿,以用户观点为主线和骨架,vault 中的摘抄、文章作为论据,可指定公众号、知乎、随笔风格。触发说法如「把这些观点写成一篇」「把 X 主题写成文章」「写成草稿」「起草这篇」。

主要能力与流程:收集素材(单篇取「我的看法」与原文摘要,主题取观点综述或某 MOC 下多篇「我的看法」);确认角度与风格,先读个人说明书中对应平台的读者与口吻定位,再就本篇具体角度、标题方向与用户确认,文件缺失时才回退询问;搭结构并先给大纲确认;成文时以观点为主线、摘抄作佐证,用双链注明来源;落草稿到 vault 草稿目录,命名为日期加标题,frontmatter 含 tags、status、source_notes;最后回执草稿路径、字数与结构。另含标题工序,覆盖至少两种公式给出三个候选标题交用户选择,并提供去 AI 味自检清单。

使用方式:以自然语言说明目标并提供必要输入;Agent 先判断是否命中本技能,再检查依赖、配置、权限与风险动作;可预览的先给预览,涉及删除、覆盖、发送、发布、写远端状态时先征求确认;执行后验证真实输出并给出完成回执。安装命令:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-compose -y。配置路径为 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-compose/config.yml,可用 SOIA_PKM_COMPOSE_CONFIG_FILE 指定自定义路径;无需私有配置时可不创建。API key、cookie、session 等敏感信息只能放入私有 config 或各自登录态,不得写入仓库、vault 正文或日志。

限制与边界:只落到 50_草稿/,不碰摘抄原文;观点必须来自用户,不凭空造观点或添加用户未表达的判断;缺料先问不编;引用 vault 内容用双链注明。具体依赖、前置与第三方 skill 关系以 SKILL.md 后续说明为准,资料未提供更多细节。