Skip to content

Security: songhai-dg/review-write

Security

SECURITY.md

Security policy

Runtime boundary

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 的审查。

安装前核验

  1. 使用官方仓库 songhai-dg/review-write 和对应 Release tag;
  2. 检查 Release 中的 SHA-256 文件与 GitHub artifact attestation;
  3. 阅读 SKILL.md、scripts/reviewwrite_lint.py 和引用的文件;
  4. 已有安装时先确认版本和路径,不覆盖未知目录;
  5. 在受控项目或临时目录先验证发现与预检行为,再扩展到长期工作环境。

漏洞与安全问题

请不要在公开 Issue 中提交未公开漏洞、凭证、私人文本或受保密约束的材料。对安全问题,请通过 GitHub 的私密安全通告渠道联系维护者:https://github.com/songhai-dg/review-write/security/advisories/new。

报告应说明受影响版本、复现步骤、实际影响和可公开的最小样例。维护者会先确认问题,再协调修复与披露。

There aren't any published security advisories