kelly-wechat-content

Build and operate a WeChat editorial content library in Busabase. Use when a team wants reusable source material, linked article drafts, an editorial kanban board, a publishing calendar, or a source-c

SKILL.md

GitHub

公众号内容工作台

把可复用的资料和每篇文章的写作、审核、发布排期分开维护。一个资料可以关联多篇文章, 一篇文章可以关联多个资料。这个包同时是操作 Skill、可安装模板和只读内容工作台。

开始工作

  1. 先读 Busabase Skill,确认账号、空间和用户指定的本应用目录。
  2. 只读取该目录内 metadata.appId = kelly-wechat-content 的资源: resourceKey = sources 是资料库,resourceKey = articles 是文章排期。 不按相似表名接管工作区其他表,也不把演示资料当成用户事实。
  3. 安装后的两张表、原生视图和素材 Drive 是数据来源。AirApp 只读这些数据; ?demo=1 是明确选择的演示,连接失败不能自动退回演示。
  4. 每张表一次最多读 50 条,保留游标;继续读取必须是另一次明确翻页。 涉及全量整理时说明范围和批次,不能把全表扫描藏在刷新或搜索里。

两张业务表

资料库 sources

每行一份原始材料。title 是人能识别的标题;kind 是文章、报告、截图或笔记; topic 是工作流、产品实践或内容增长。summary 保存摘要,url 保留原文地址, attachment 保存用户后续添加的原始文件。source-date 是资料日期,verified 表示 来源已人工核对,notes 记录适用范围、需要补证据或版权限制。

search-text 是这张表里的文字摘录,不是附件的「可搜索文本」。如果上传 PDF 或截图, 想让文件正文可检索,另让 Agent 提取/OCR 并写入对应附件的可搜索文本,再做关键词验证。 仅填元数据或在聊天里给摘要,不能当作已完成正文检索准备。

文章排期 articles

每行一篇文章。status 是 planned 选题、drafting 写作中、review 待审核、 scheduled 待发布、published 已发布。owner 是负责人的名字, publish-date 是计划发布日期,sources 是允许多条值的资料库关联。 outline 保存提纲,draft 保存 Markdown 草稿,review-note 保存具体审核意见。 public-url 只有真实发布后才填。日期排到了今天,不等于已经发布。

日常操作

  • 整理资料:先用标题、来源和主题检查重复,再新增材料;保留出处,未经核实的 主张放在备注里,不替用户猜事实、统计结果或引用。
  • 从资料出选题:读相关资料,提出文章标题和提纲,为每篇文章关联所用资料; 不重复复制整份资料。更新同一份资料时,引用仍指向同一记录。
  • 写作与审核:先读取稿件及其关联资料。把修改提交为有说明的 ChangeRequest, 提出具体待核对项。需要审核时明确要求保留提案,不自行审批或合并。
  • 排期:先查看看板、日历和负责人,给出排期建议;用户确认后再更新日期或状态。 不凭 scheduled 状态调用公众号发布接口。
  • 回顾复用:按资料关联统计哪些文章使用了它。这个是阅读分析,不擅自把文章 修改成“已发布”或把未核对资料标为“来源已核对”。

两张表已经能承载多对多关系。只有用户明确需要记录每次引用的段落、页码、用途时, 才提出第三张「文章引用」表的结构与迁移方案;不要安装时先替用户扩表。

权限与写入

遵循 Busabase Skill 的 ChangeRequest 流程。需要人先检查的草稿/资料更新明确要求审核; 有写入权限时服务端可能立即合入,不能把“有历史”当作“等待审批”。 本 AirApp 不提供批准、退回或对外发布的伪操作,审核由 Busabase 原生变更请求界面进行。 对外发布、截图上传到论坛、订阅任务和第三方账号接入都需要各自明确授权。

本包提供什么

  • 资料库:全部资料、待核对资料、资料画廊。
  • 文章排期:文章列表、进度看板、发布日历、待审核。
  • 编辑规范 Doc:引用规则、审核检查和示例工作流程。
  • 示例素材 Drive:演示材料及真实运行截图;不会保存密钥或用户数据。
  • 内容工作台 AirApp:总览、资料浏览、文章表格/看板/日历和待审核阅读。

查看 references/scenario.md 了解示例故事和每个视图的验收路径。

演示与安装

当前 busabase-package@1 只打包表格视图。因此安装时先建立原生表格和待审核筛选, AirApp 的看板/日历可直接查看同一批记录。完成安装后,按下面的限定步骤补齐原生 资料画廊、状态看板和发布日历;不能把缺失的视图说成已安装。

node scripts/setup-views.mjs --base-url <已确认的Busabase地址> --folder <安装目录节点ID>
# 检查预览后,创建本模板声明的三个原生视图:
node scripts/setup-views.mjs --base-url <已确认的Busabase地址> --folder <安装目录节点ID> --yes

脚本只处理该目录内已归属本模板的两张表;重复运行不新增视图,不修改已有不同配置的 视图。写入由服务端权限决定立即合入或等待审核;脚本不会自行审核。 通过已连接 Agent 完成安装时,也可以让 Agent 读取 references/native-views.json, 按这三个声明提交 View 变更请求并读回核对。

演示记录是虚构编辑团队的数据,安装后可删除或替换。每张表少于 50 行。 演示与实际安装读取同一组记录,关联在安装时转换为目标空间的新记录 ID。 图片文件放在可安装的素材 Drive 中;busabase-package@1 不携带记录附件值, 因此附件字段初始可为空。Agent 可在用户授权后将 Drive 中所需文件附到记录。

npx busabase-cli@latest check ./skills/kelly-wechat-content
npx busabase-cli@latest install ./skills/kelly-wechat-content

同一空间已有本模板时,安装器会因全空间唯一的节点 slug 拒绝第二次安装; 明确需要并行保留两套场景时,为第二次安装指定新的 --into-folder,并加 --rename。 安装后从新目录节点 ID 再运行一次 setup:views,工作台会按所属目录读取各自的数据。

已安装实例的资源 ID 属于用户空间,不应写回本模板。源码和包文件保存在 content/kelly-wechat-content-app/,本地运行支持 pnpm dev;安装后在 Busabase 中运行同一版本。