Skip to content

README.cn.md

Latest commit

 

History

History
192 lines (144 loc) · 6.23 KB

README.cn.md

File metadata and controls

192 lines (144 loc) · 6.23 KB
Raw

sci-using-kit

English | 中文

Skills SCI Writing License: MIT

面向 Codex 的 SCI 论文写作 skill family：用一套“证据有边界”的工作流，帮助 agent 完成文献核验、论文修订、结果讨论、论文配图、创新性定位、审稿预检、LaTeX 修改和投稿打包。

sci-using-kit 参考了 superpowers 的“主入口 + 分支 skill”组织方式，但它不是代码开发框架，也不是自动写完整论文的黑箱。它的目标是让科研写作 agent 在长上下文、多文献、多实验、多轮修稿中保持证据纪律。

它要解决的问题很朴素：claim、citation、experiment、result、prose 必须互相对得上。

为什么需要它

科研写作 agent 常见的问题很稳定：

  • 文献检索上下文污染主写作上下文。
  • 把弱证据写成强结论。
  • 把任务、硬件、数据集、指标都不一致的 prior work 写成直接性能对比。
  • 润色时删除必要 caveat，让论文看起来更顺，但学术边界变差。
  • 生成漂亮但不受证据约束的配图，出现错误语言、编造标签、误导性坐标轴或私有基础设施信息。
  • 投稿或开源时把本地路径、私有材料、未公开数据一起打包出去。

这个 kit 给 agent 一条固定路径：

sci-using-kit
  -> 判断项目阶段
  -> 输出 Routing Decision
  -> 选择分支 skill
  -> 保留科研写作 prompt kernels
  -> 汇报证据、风险和验证结果

安装

Windows PowerShell

git clone https://github.com/keithhegit/sci-using-kit.git
cd sci-using-kit
.\scripts\install.ps1

macOS / Linux

git clone https://github.com/keithhegit/sci-using-kit.git
cd sci-using-kit
bash scripts/install.sh

默认会把 skills/ 下的所有 skill 复制到：

  • Windows: %USERPROFILE%\.codex\skills
  • macOS/Linux: $HOME/.codex/skills

也可以手动复制各个 skill 文件夹。

推荐入口

在新的 Codex 线程里这样开始：

Use $sci-using-kit for this SCI manuscript task.

入口 skill 应该先输出：

**Routing Decision**
- Project phase:
- Task type:
- Primary branch skill:
- Additional gate skills:
- Evidence bundle to read:
- Output expected:

支持的项目阶段：

  • kickoff
  • drafting
  • revision
  • arXiv preflight
  • SCI Track B
  • repo release

Skill 列表

Skill 使用场景
sci-using-kit 开始或恢复任何 SCI 论文任务。
sci-issue-intake 用户需求、审稿意见、合作者反馈或论文问题还比较模糊，需要先拆解。
sci-literature-vetting 添加、检查、修复引用和 related work。
literature-review-search 检索文献，并整理成 citation-safe 的文献表格。
sci-paper-revision 在不增强 claim 的前提下改写、压缩、去 AI 味、重组正文。
sci-evidence-discussion 把表格、日志、图、HIL、simulation、measurement 写成结果和讨论。
sci-figure-generation 规划、生成、核验、配 caption 并打包证据约束型 SCI/arXiv 论文配图。
sci-comparative-positioning 处理 novelty、speedup、improvement、efficiency、prior work 对比。
sci-reviewer-preflight arXiv、内部审阅或 SCI 投稿前做审稿人视角风险审查。
sci-latex-editing 修改 LaTeX、Overleaf 导出、图表、引用、label/ref、appendix。
sci-submission-preflight 准备 arXiv、期刊/会议、source zip、metadata、license、repo release。

核心原则

这套 kit 是“superpowers 风格外壳 + SCI 证据写作内核”：

  • 状态可恢复：重要 claim、evidence、decision、open question 必须能跨会话恢复。
  • 文献隔离：文献检索 agent 输出压缩矩阵，不直接污染主写作上下文。
  • Claim/evidence 对齐：所有重要 claim 必须能回到 evidence。
  • 引用防幻觉：没有验证的引用不能写进正文。
  • 图即 claim surface：图中的标签、坐标轴、单位、视觉比较和 caption 都要过 evidence 与 privacy 检查。
  • 比较要合法：不可比较的 prior work 不能写成直接提升。
  • 证据等级分明：HIL、simulation、field validation、RF validation 等证据等级必须区分。
  • LaTeX 修改要克制：尽量局部、可编译、可追踪，不同时改结构和科学内容。

完整 prompt-kernel 参考在：

skills/sci-using-kit/references/prompt-kernels.cn.md

仓库结构

sci-using-kit/
  README.md
  README.cn.md
  LICENSE
  .gitignore
  skills/
    sci-using-kit/
    sci-issue-intake/
    sci-literature-vetting/
    literature-review-search/
    sci-paper-revision/
    sci-evidence-discussion/
    sci-figure-generation/
    sci-comparative-positioning/
    sci-reviewer-preflight/
    sci-latex-editing/
    sci-submission-preflight/
  scripts/
    install.ps1
    install.sh
    validate_skills.py
  .github/workflows/
    validate.yml

版本说明

v0.2.0 - SCI 论文配图分支

  • 新增 sci-figure-generation，用于证据约束型图形摘要、系统/工作流图、结果证据快照、imagegen 提示词、caption 和 Overleaf 图资产接入。
  • 新增 Figure-as-Claim 纪律：图中的标签、坐标轴、单位、视觉比较和 caption 都必须接受证据检查。
  • 增加 arXiv 英文图、混合单位可视化、生图幻觉和私有基础设施泄露的安全规则。

v0.1.0 - 初始 SCI skill family

  • 引入入口 skill 以及文献核验、论文修订、结果讨论、比较定位、审稿预检、LaTeX 编辑和投稿打包等核心分支。

校验

python scripts/validate_skills.py

Windows PowerShell 推荐：

$env:PYTHONUTF8='1'
python scripts\validate_skills.py

边界

这个仓库只放可复用 skill 和公开脚本，刻意不包含：

  • 私有论文稿件
  • 本地研究日志
  • 未公开项目数据
  • 本地 Windows 路径
  • 具体论文草稿
  • workflow 审计报告

License

MIT License. See LICENSE.