Release 中的 .skill 运行时包只包含:
SKILL.md与agents/openai.yaml;references/下的 Markdown 规则、体裁包和 few-shot;scripts/reviewwrite_lint.py本地 UTF-8 文本预检;scripts/reviewwrite_gate.py本地结构化正文抽取与严格交付门禁;scripts/reviewwrite_semantic.py本地创建和校验与正文 SHA-256 绑定的语义复核记录;scripts/runtime_io.py跨平台 UTF-8 标准输入输出配置;scripts/long_document_review.py本地超长文本分块预检与全局索引;scripts/office_qa.py本地 DOCX/PPTX 只读结构审计。scripts/reviewwrite_update.py和release-policy.json,仅在用户或平台明确启用更新检查时使用;- 一个不含真实字体名称的
examples/office-qa/font-profile.example.json配置结构样例。
默认写作任务不会调用更新器。更新器只有在用户或平台明确启用更新检查/下载时才联网;它可能读取 GITHUB_TOKEN 以访问 GitHub API,并在要求 attestation 时调用本机 gh。它只检查和下载 Release 资产,不上传用户正文、不修改输入文件,也不自动覆盖已安装技能。更新缓存和下载文件写入平台缓存目录或用户通过 REVIEWWRITE_CACHE_DIR 指定的目录。
reviewwrite_update.py status 只读取本地版本和缓存元数据,不联网;缓存过期后的 check 也应安排在当前写作任务完成后。检查过程不使用随机触发。
reviewwrite_lint.py 只读取用户指定的本地文件或标准输入,输出诊断结果;它不联网、不读取凭证、不修改输入文件,也不会上传正文。office_qa.py 默认只读取用户指定的 .docx/.pptx 和可选的本地 profile/字体清单;它不会修改或上传输入文件。仅当调用者显式使用渲染模式时,它才会尝试调用本机可发现的 soffice 和可选 pdftoppm,并只向调用者指定的输出目录(或临时目录)写入 PDF/PNG 预览。
reviewwrite_gate.py 默认要求结构化响应,抽取唯一 deliverable_body 后执行严格预检,并验证 reviewwrite_semantic.py 创建的正文绑定复核记录;通过时只输出正文,失败时不输出正文。语义脚本只在显式 init --output 时写入复核 JSON,不修改正文、不联网,也不把复核记录冒充事实与引用核验。
long_document_review.py 只读取用户指定的 UTF-8 文本或标准输入,按有限重叠分块调用本地预检器,并在本地生成行号、数字、标题、术语变体和重复段落索引;它不联网、不读取凭证、不修改输入文件,也不会上传正文。
reviewwrite_route.py 只读取任务元数据并输出本地路由 JSON,不联网、不修改正文;实际接入后仍必须执行正文终检。
宿主智能体、模型提供方和用户自行启用的工具可能具有不同权限。ReviewWrite 不能替代宿主平台的权限确认、数据处理政策或对不可信 Skill 的审查。
- 使用官方仓库
songhai-dg/review-write和对应 Release tag; - 检查 Release 中的 SHA-256 文件与 GitHub artifact attestation;
- 阅读
SKILL.md、scripts/reviewwrite_lint.py和引用的文件; - 已有安装时先确认版本和路径,不覆盖未知目录;
- 在受控项目或临时目录先验证发现与预检行为,再扩展到长期工作环境。
请不要在公开 Issue 中提交未公开漏洞、凭证、私人文本或受保密约束的材料。对安全问题,请通过 GitHub 的私密安全通告渠道联系维护者:https://github.com/songhai-dg/review-write/security/advisories/new。
报告应说明受影响版本、复现步骤、实际影响和可公开的最小样例。维护者会先确认问题,再协调修复与披露。