SuperAPI AI 工具集

plan-page

办公与效率

查看项目

更新于 10-16 02:33

技能介绍

用途:plan-page 处理“计划页”。用户读的是页面而非回复,规则规定何时发布以及回复中保留什么。一个主题对应工作中被改变的一件事,只有一个页面,其文件为 <plans>/topics/<slug>.md,保存当前状态;延续该主题的每份计划是一次迭代,只携带本次增量。

主要能力:渲染器 node .agents/pstack/plan-page.mjs <plan> 把计划文件与主题文件渲染到 <plans>/artifacts/ 下的本地副本,该副本可由已提交的计划与主题文件重新生成,后者才是记录。node .agents/pstack/plan-page.mjs --index 渲染每个主题页及链接它们的索引(索引不发布)。提供 Render、Refresh、Check、Repair、PR、Change 等模式,覆盖发布、重渲染、校验、修复、写 PR 正文或评论、修改页面形态。sync-pstack 会把该渲染器与 status.mjs 分发到其管理的项目。

使用方式:写计划或主题文件前先读 references/shape.md(包含所有文件形态、页面顺序与渲染器拒绝条件)。先确定主题,再写计划:一次性的修复或检查可无主题、保留自己的页面;只读请求也有主题,其计划从仓库外副本渲染并只发布到该主题的 Page: URL。用 Status: 下的 Topic: <slug> 命名主题,或经 pageTopic.field 列出的首个条目;用 Playbook: <name> 命名所用 playbook。按 shape.md 先写 ## Brief 再写 ## Teach。首次发布前与每次修订后走 Check 的阅读清单,再运行渲染命令;渲染器会拒绝它可检查的每种形态并指出修法,应修改计划或主题文件而非 HTML。用 Artifact 工具把打印出的文件发布到主题的 Page: URL,供用户评论;页面打不开时重新发布并替换该行。Check 额外运行 --check,只跑拒绝检查、不写文件。Repair 前先把各文件复制到运行目录留作夹具,再修源头并重新渲染发布到同一 URL。PR 模式下,PR 正文即该 PR 计划的页面,渲染为 GitHub Markdown,输出 <plans>/artifacts/<name>.pr.md,并用 gh pr create/edit 与打印的 --attach 行创建或更新;对他人 PR 只留一条覆盖自己提交的评论,用 gh pr comment 发布。

限制:渲染器源码位于 dotai 检出中的 skills/sync-pstack/assets/pstack/plan-page.mjs,其测试在 sync-pstack.test.mjs;仅单个项目计划写的章节应放入该项目 playbook 前置元数据,不得放入渲染器。修改渲染器须走 sync-pstack 的 Lesson 模式并遵守其门禁、语料规则与交付流程;具体定价、平台支持范围等资料未提供。