mylc2010/sci-translation-skill

选用指南

AI 根据 README 整理 · 2026/10/20 12:06:44

使用方式

作为 Agent Skill 加载到支持技能目录的宿主（如 Codex、Claude Code 等）中使用，通过提示词触发翻译或审校流程。

查看 README 依据

- 医学/生物：研究设计、关联与因果、效应量/区间、样本、剂量、终点和时间点。 - 工程/材料：实验条件、单位/量纲、实测与仿真、误差和适用范围。 这些是新增审查规约，不是大规模跨领域实测结论；医学稿件需专业人员终审。 ## 安装与运行时 将包含 SKILL.md 的 sci-translation-skill 目录放入宿主实际支持的技能目录，避免重复嵌套。 支持从仓库安装技能的宿主也可使用本仓库地址；是否能自动安装取决于宿主及其权限，不要把给出链接等同于安装成功。 需要手动安装的参考： 本地 Codex 的已使用位置是 ~/.codex/skills/sci-translation-skill/SKILL.md。 在本仓库根目录运行的安装示例（目标已有版本时先备份）： ```bash mkdir -p ~/.codex/skills/sci-translation-skill rsync -a --exclude '.git/' --exclude '.DS_Store' --exclude '__pycache__/' ./ ~/.codex/skills/sci-translation-skill/ ``` 安装后在宿主中刷新技能或新开会话，确认能够读取 SKILL.md；本文件不替代当前宿主配置文档。 ### 支持的 Agent

| [OpenCode](https://opencode.ai/docs/skills) | `~/.config/opencode/skills/sci-translation-skill/` | 官方支持该目录；本仓库未实机验证 | | [Hermes Agent](https://hermes-agent.nousresearch.com/docs/guides/work-with-skills/) | `~/.hermes/skills/sci-translation-skill/` | 官方支持该目录；本仓库未实机验证 | Antigravity、Cursor、Windsurf、Aider 等宿主须先确认其技能/规则加载接口，再显式加载入口及所需 references。Dify、FastGPT、Coze 或自建 Harness 还需自行实现角色节点、依赖、文件传递及运行记录；仅上传知识库不构成多 Agent 流水线。 没有这些宿主的逐平台实机验证，不能仅凭复制文件宣称全部“开箱即用”。 技能不要求固定 Sonnet/Opus，不擅改宿主配置。脚本只需 Python 3 标准库。 ## 可复制提示词 首次使用：先审术语，**本轮不要翻译**。 ```text 使用 $sci-translation-skill，为这篇完整论文做翻译前术语锁定。

部署要求

需要 Python 3 标准库运行检查脚本，并需将技能目录放入宿主支持的技能目录。

查看 README 依据

| [OpenCode](https://opencode.ai/docs/skills) | `~/.config/opencode/skills/sci-translation-skill/` | 官方支持该目录；本仓库未实机验证 | | [Hermes Agent](https://hermes-agent.nousresearch.com/docs/guides/work-with-skills/) | `~/.hermes/skills/sci-translation-skill/` | 官方支持该目录；本仓库未实机验证 | Antigravity、Cursor、Windsurf、Aider 等宿主须先确认其技能/规则加载接口，再显式加载入口及所需 references。Dify、FastGPT、Coze 或自建 Harness 还需自行实现角色节点、依赖、文件传递及运行记录；仅上传知识库不构成多 Agent 流水线。 没有这些宿主的逐平台实机验证，不能仅凭复制文件宣称全部“开箱即用”。 技能不要求固定 Sonnet/Opus，不擅改宿主配置。脚本只需 Python 3 标准库。 ## 可复制提示词 首次使用：先审术语，**本轮不要翻译**。 ```text 使用 $sci-translation-skill，为这篇完整论文做翻译前术语锁定。

使用 $sci-translation-skill，先扫描全稿并交术语审阅表；如果我已明确批准这张完整表，校验后直接翻译全文。 在新目录交付，不覆盖原文。各块共享同一版本词表和研究上下文。 覆盖正文、图注、表格、公式说明、算法与附录；最后核对摘要的论断范围。 交付英文稿、锁定词表、必要的对齐/审校记录和待确认项，不强制生成空文件。 ``` ## 检查工具 ```bash bash references/test-skill-integrity.sh python3 scripts/check_glossary_gate.py terminology-glossary.json --source source-snapshot.txt python3 scripts/audit_translation.py source.tex target.tex \ --glossary terminology-glossary.json \ --alignment alignment.json \ --output qa-report.json ``` 术语门槛：0=审批记录与词表/原稿快照匹配；1=未放行；2=输入错误。译稿审计：0=已实现检查未发现差异；1=待核查；2=输入错误。

已知限制

作者明确说明未在除 Codex 外的宿主上实机验证，且脚本检查结果不表示投稿就绪，也不认证领域准确性。

查看 README 依据

下表表示这些宿主有加载 `SKILL.md` 目录的接口，**不是本 skill 在每个平台上的端到端实机认证**；当前仅 Codex 本地安装已使用。复制时保留 `references/`、`scripts/` 和 `examples/`。 | Agent | 技能目录或安装入口 | 本仓库验证状态 | |---|---|---| | Codex | `~/.codex/skills/sci-translation-skill/` | 已在本地使用 | | [Claude Code](https://code.claude.com/docs/en/skills) | `~/.claude/skills/sci-translation-skill/` | 官方支持该目录；本仓库未实机验证 | | [OpenClaw](https://docs.openclaw.ai/tools/skills) | 通过 `openclaw skills install ./path/to/sci-translation-skill` 导入，或放入其技能目录 | 官方支持本地技能导入；本仓库未实机验证 |

0 **不表示投稿就绪**。未提供 alignment 时，不声称完成逐段覆盖或术语合规检查。 有些正确的数字顺序/格式调整也可能触发差异，需要记录人工处置。 原 shell 入口仍可使用： ```bash bash references/test-translation-structure.sh source.tex target.tex glossary.json ``` 这两个 shell 测试脚本不做“AI味检测”，也不认证领域准确性。 ## 主要文件 - [SKILL.md](SKILL.md)：入口与放行条件。 - [术语审批契约](references/glossary-schema.md)：审阅表、作者确认门槛、JSON schema 与 alignment 格式。 - [术语门槛脚本](scripts/check_glossary_gate.py)：校验版本、条目和原稿快照；不代替真实作者审批。 - [角色契约](references/agent-contracts.md)：真实工具和文件所有权。 - [语言指南](references/academic-phraseology-guide.md)：忠实、简洁与自然表达。