beeweave: Skill for Claude Code

BeeWeave 文章发布

这个 skill 负责把一篇已经完成的创作草稿变成已发布作品，并把高信号版本内化到 wiki。

发布不是重写文章。除非用户明确要求修改正文，只做四件事：

1. 定位唯一的草稿文件
2. 移动到 articles/published/ 并更新 frontmatter 状态
3. 更新对应写作 trace 的发布元数据
4. 用已发布文件作为 source 触发 beeweave-ingest skill 流程

配置解析

如果用户请求里包含 @<name>，只从 ~/.beeweave/config.<name> 读取配置。否则只从 ~/.beeweave/config 读取配置。

必须读取：

• BEEWEAVE_WORKBENCH_PATH
• BEEWEAVE_VAULT_PATH

如果配置文件不存在，或缺少任一必需变量，先向用户说明无法找到完整 BeeWeave profile，然后停止。不要猜测路径，不要从当前目录向上查找 workbench，也不要直接写入 vault。

@<name> 是路由指令，不是文章标题或搜索词。解析配置后，从用户实际发布请求中移除它。

草稿定位

只在以下目录内找草稿：

$BEEWEAVE_WORKBENCH_PATH/articles/drafts/

用户可以用三种方式指定文章：

• 精确路径，例如 workbench/articles/drafts/2026-07-08-article-agent-workflow.md
• 文件名或 slug，例如 agent-workflow
• frontmatter title 或一级标题

定位规则：

1. 如果用户给了路径，展开并校验它必须位于 drafts 目录内。
2. 如果用户给了文件名或 slug，只匹配 drafts 目录下的 Markdown 文件。
3. 如果 slug 没有唯一命中，再读取候选文件的 frontmatter title 和一级标题匹配。
4. 如果没有命中或有多个候选，列出候选并请用户明确选择。不要发布多个文件，除非用户明确要求批量发布。

发布动作

目标目录固定为：

$BEEWEAVE_WORKBENCH_PATH/articles/published/

发布时：

1. 创建 articles/published/ 目录，如果它不存在。
2. 保留原文件名移动到 published 目录。
3. 如果目标文件已存在，不覆盖，在文件名末尾追加 -v2、-v3。
4. 更新 Markdown frontmatter：

   status: published
   published: YYYY-MM-DDTHH:MM:SS±HH:MM
   updated: YYYY-MM-DDTHH:MM:SS±HH:MM
   

5. 如果没有 frontmatter，添加最小 frontmatter：

   ---
   title: "<从一级标题或文件名推导>"
   type: article
   status: published
   published: YYYY-MM-DDTHH:MM:SS±HH:MM
   updated: YYYY-MM-DDTHH:MM:SS±HH:MM
   tags:
     - writing
   ---
   

published 和 updated 必须使用当前本地时区的 ISO-8601 秒级时间戳，例如 2026-07-08T17:05:42+08:00。发布已有草稿时保留原 created；如果原 created 只有日期，不要在发布流程中猜测补秒，除非用户明确要求归一化旧稿。

保留正文、质检报告、已有 created、type、format、tags、sources 等字段。不要把 draft 目录中的其它文件一起移动，不要使用通配符或递归移动。

Trace 发布元数据

发布成功后，尝试更新对应写作 trace。trace 位于：

$BEEWEAVE_WORKBENCH_PATH/writing/traces/

匹配规则：

1. 优先查找 trace.json 中 draft_path 等于原草稿路径的 trace。
2. 如果未命中，再查找 output_paths 或 revision_events[].draft_path 中包含原草稿路径的 trace。
3. 如果仍未命中，不创建新的基础 trace，不阻断发布和 wiki ingest，在最终回复中说明“未找到对应写作 trace”。
4. 如果命中多个 trace，选择 updated_at 或 created_at 最新的一个，并在最终回复中说明选择依据。