SuperAPI AI 工具集

paperclip-distill

写作与研究

查看项目

更新于 10-16 03:15

技能介绍

用途:将 Paperclip 中某项目或根 issue 的活动(issue 描述、评论正文、文档正文)提炼为持久 wiki 页面,产出面向读者的项目 standup、项目索引,必要时生成 decisions.md 与 history.md。适用于 cursor-window 蒸馏、历史回填(backfill)以及 UI 中手动触发的 distill-paperclip-now。若操作 issue 的 operationType 为 ingest 或 query,应改用 wiki-ingest 或 wiki-query。

主要能力:读取完整源 bundle(issue 列表、评论引用、文档引用、source hash、cursor window),先写 wiki/projects/<slug>/standup.md,再写 index.md,可选写 decisions.md 与 history.md,并刷新 wiki/index.md、追加 wiki/log.md。standup 固定分区为 Frontmatter、Executive Readout、What Changed、Decisions、Blockers/Risks、Next Actions、Links;index 固定分区为 Frontmatter、Overview、Current Direction、Workstreams、Decisions、Open Risks/Blockers、References。

使用方式:Phase 1 中所有蒸馏、回填与 cursor-window 操作都写入默认 wiki 空间,操作 issue 应携带 spaceSlug: "default",否则停止并在评论中说明不匹配。需读取目标空间 AGENTS.md 以遵循页面约定,调用 wiki_search、wiki_read_page、wiki_write_page、wiki_list_sources、wiki_read_source 时始终传入操作 issue 的 wikiId 与 spaceSlug。源 bundle 随操作上下文提供,无需自行组装。

限制:不得把 Paperclip 资产/附件或工作产物当作源文本,它们仅为元数据,禁止访问 /api/assets/:id/content,禁止解引用工作产物 URL、预览 URL、制品 URL 等链接目标;如被要求蒸馏附件内容,应指向 Phase 5 资产/工作产物安全门策略。避免日期戳作标题、流程状态列表、逐 issue 一行、机械时间戳、无解读、正文出现 UUID 等不透明标识。bundle 无持久信号时不写项目页,只记低信号跳过日志并关闭操作 issue。bundle 警告需在补丁上标记 human_review_required: true。不得修改 raw/ 下任何文件。