SuperAPI AI 工具集

write-notion

设计与创作

查看项目

更新于 10-15 21:52

技能介绍

用途:把团队文档(如设计文档/RFC、决策记录、问题清单)发布为可供同事仅凭页面审阅的 Notion 页面。设计或决策置于页面顶部,细节可一键展开,人物以提及方式引用,并校验存储页面与预期一致。

主要能力与边界:负责文档形态、Notion 页面布局、人物引用、表格、图表、Notion Markdown 编辑机制与发布后验证;不负责句子级写作(由 copydesk 负责),图表由 technical-figure 或项目自有工具绘制,此处只决定需要哪些图并上传;跟踪器议题与 PR 由 write-issue、draft-pr 负责,页面仅链接。不适用于:应留在聊天中的回答、数据库 schema/视图/属性管理、把聊天或会议内容存为笔记、会议预读与议程、跨页面研究综合、把规格拆成任务、以文件或其他平台交付的文档。

用法要点:先读取目标页或父页、同层页面和团队模板,匹配语言与惯例;确认可读范围,排除机密与个人信息。先定体裁与章节顺序再起草。新建用 notion-create-pages,更新用 notion-update-page,取最小编辑。无可用 Notion 连接时,以 Notion Markdown 交付并说明未发布,不要隐式安装或认证连接器。

布局与规则:默认设计文档顺序为头部标注(Status、Owner 提及、Reviewer 角色、Target、日期提及、仓库与跟踪器链接)、Summary、Context and scope、Goals(与非目标)、Design、横切关注点、Alternatives、测试计划/评估、Milestones、Open questions、References;无内容可写的章节直接删除。摘要、上下文、目标、图表、开放问题保持可见,细节默认放入 toggle。表格须设 header-row="true" 并用 colgroup 设列宽。人物须用 notion-get-users 得到的用户提及,尽量少提及,通常仅 Owner。术语、状态在正文、表格、图注中须一致,改动术语需重新渲染并上传图表。

编辑与验证:编辑前先抓取,小改动用 update_content 并以最短唯一 old_str,失败则重抓后用 replace_content;整页替换前若有讨论需告知用户评论锚点可能丢失。替换时原样保留带 url/src 的标签,删除子页面标签会删除或移动子页面;未获确认不得 allow_deleting_content: true。每次结构编辑后抓取校验:无纯文本人名、toggle 缩进正确、表格属性与列宽、图片与子页面数量、数字与来源一致、状态一致、术语与图注一致、链接对读者可打开。

限制:部分事实(如具体分类、收费、平台支持细节)暂未提供。