SuperAPI AI 工具集

scribe

写作与研究

查看项目

更新于 11-06 17:22

技能介绍

用途与权限

Scribe 用于把给定的技术来源材料整理成读者能照着执行、并能追溯依据的技术文档。它不会编造来源事实,会保留绑定的命令、路径、数值、顺序、警告和恢复步骤。校验通过并不代表内容具备独立的 factual truth(事实真实性)。

只有在获得文档创建或修订授权时才进行写作;隐式调用不会授予写入或修复权限。审计是独立操作,只写入审计报告,不得修改文档、文档包或绑定的来源材料。

工作方式

根据请求和来源推导受众、读者任务与范围。只有当来源无法确定重要的发布或内容策略选择时才询问用户;缺失的来源事实会被视为未解决的缺口。在确定文档计划前、出现失败或方向变更后,以及报告完成前,都需要进行推理核对,并在最终报告和停止报告中按检查点迹记录推理检查点。

写入与审计

每份文档都是一个交付物:在写入模式下,直接在用户指定位置创建或编辑实际文件。两种操作都会依据文档包(document-bundle)和来源绑定规则,逐个检查 document-bundle.json 中列出的文档与其绑定来源。文档包属于支持状态,需从 templates/document-bundle.json 写入仓库外的临时目录。可在一次运行中列出多份文档统一处理。

写入需遵循 Write 流程;其语言检查采用 MTE-1,这是受 ASD-STE100 启发的原创约定,不应声称符合官方 ASD-STE100,也不应暗示本技能包含其获批词词典。write 命令只检查文档,不编辑任何文件,示例命令为:

python /absolute/skill-root/scripts/cli.py --repo-root /absolute/repo
--input bundle=/absolute/temp/document-bundle.json --format json write

审计需遵循 Audit 流程:以同样方式运行 audit,并使用 --input slug=<audit-slug>。它只写入 .first-four-hours/scribes/<slug>/scribe-audit.md,每份文档一节。

完成条件

写入仅在 write 返回 result.status: complete 时完成。若为 incomplete,只处理列出的缺口,并报告每个缺口的负责人;否则按各诊断项 required_action 的指示修复其点名文档或文档包,然后重新运行。审计仅在 audit 返回 status: complete 时完成;需报告 scribe-audit.md 路径以及每份文档的 document_sha256 与发现项。若仍有重要的读者任务未获支持,即使结果通过也不算完成,应报告确切缺口及其下一负责人。最后给出一个可选的下一步:一个围栏式、自包含的提示词,指明所需的仓库、issue、PR 或产物,或说明无需下一步。只有用户回答“yes”才会启动,且通过其点名的任一技能执行;但 charter、diagnose 或 ticket 步骤需由用户以其 /<skill> 命令运行。