onescience-coder · diff
git:20260610.3755d06 to git:20260612.7611060
30 added, 6 removed. Audit A to A.
---
name: onescience-coder
- description: 面向 OneScience 代码库的实现技能。用于用户已进入实现阶段时分析可行性、选择最小改造路径，并按需完成 DataPipe、模型、组件或配置相关代码实现。若用户只是询问技能路线、规划路径、先不要写代码或尚未授权实现，应先进入 onescience-workflow / onescience-role，而不是直接触发本 skill。
+ description: 面向 OneScience 代码库的实现技能。用于用户已进入实现阶段时分析可行性、选择最小改造路径，并按需完成 DataPipe、模型、组件或配置相关代码实现；代码生成完成后必须执行静态需求一致性 review，逐条核对生成代码是否满足参数、结构、输入输出、组件复用和文件落点等要求，并根据 review 反馈回改代码。若用户只是询问技能路线、规划路径、先不要写代码或尚未授权实现，应先进入 onescience-workflow / onescience-role，而不是直接触发本 skill。
---
# OneScience 代码实现
## 入口边界
如果用户只是要求“只告诉我技能路线”“先不要写代码”“先做规划”“先看怎么走”，或当前请求尚未授权实现代码，本 skill 不应继续做 DataPipe、模型或配置方案设计。
此时应返回上游路由语义：
- 当前应先进入 `onescience-workflow`
- 若已识别领域与任务类型，下一跳应进入 `onescience-role`
- `onescience-coder` 只能作为未来执行入口，不是当前下一跳
不要在这种情况下读取 datapipe / model / contract 卡片，也不要输出实现策略、文件落点或测试计划。
## 工作顺序
1. 如果上游已提供代码生成交接摘要，则先把它作为只读输入；不要在本 skill 内重新处理硬件探测逻辑。
- 2. 如果交接摘要中包含 `coder_reference_mode=assets_only`，不要读取 `./references/workflow.md`，直接按交接摘要读取 `./assets/` 下的模型卡、数据卡和组件契约。
- 3. 如果没有 `assets_only` 约束，再读 `./references/workflow.md`，理解 OneScience 的整体实现路径。
- 4. 复述任务，明确是数据、模型、组件还是配置问题。
- 5. 判断是否能直接复用现有实现；不能复用时，给出最小改造路径。
- 6. 只读取与当前任务直接相关的资料，再开始实现。
+ 2. 如果交接摘要中包含 `paper_repro_handoff=true`、`task_method=paper2code` 或 `domain_task_family=paper-reproduction`，只把 `task_description_content` 或 `task_description_path` 指向的 `coder_task_description.md` 作为论文复现编码任务输入；不要再读取 `reproduction_spec.md` 来补齐任务细节。若 `coder_task_description.md` 明显缺少实现必需信息，应报告任务描述不完整并要求上游重新生成，而不是自行综合两份文档。
+ 3. 如果交接摘要中包含 `coder_reference_mode=assets_only`，不要读取 `./references/workflow.md`，直接按交接摘要和 `coder_task_description.md` 读取 `./assets/` 下的模型卡、数据卡和组件契约。
+ 4. 如果没有 `assets_only` 约束，再读 `./references/workflow.md`，理解 OneScience 的整体实现路径。
+ 5. 复述任务，明确是数据、模型、组件还是配置问题。
+ 6. 判断是否能直接复用现有实现；不能复用时，给出最小改造路径。
+ 7. 只读取与当前任务直接相关的资料，再开始实现。
+ 8. 代码生成完成后，必须执行一次静态需求一致性 review；若发现代码与需求不一致，先调整代码，再复查并输出 review 结论。
## 按需读取的资料
- 使用当前技能时，首先记录当前技能所在上层目录的绝对路径，并使用 `{onescience_path}` 变量指代，后续使用卡片时，若需要该路径则相应替换
- 做方案设计时，再读 `./references/first_round_guide.md`
- 开始实现前，再读 `./references/second_round_guide.md`
- 需要选模型时，先读 `./assets/models/model_index.md`
- 需要选 DataPipe 时，先读 `./assets/datapipes/datapipe_index.md`
- 需要选组件契约时，先读 `./assets/contracts/component_index.md`
- 上游交接 `tool_family=single-cell`、AnnData、Scanpy 或 scvi-tools 时，按需使用 `./assets/bio_single_cell_tools/` 下的脚本资产；这些是实现层资产，不从 `onescience-role/bio_domain/.../scripts` 读取新入口
- 上游交接 bulk RNA-seq、variant calling、long-read、functional genomics screen、post-transcriptional regulation 或 protein design validation workflow 时，按需使用 `./assets/bio_workflow_templates/`
- 上游交接 OneScience 生信模型训练、微调、模块修改、batch 协议或 datapipe adapter 任务时，按需使用 `./assets/bio_model_templates/` 下的 handoff 模板
- 上游交接 CRISPR guide、primer/probe、plasmid verification、restriction digest 或 RNA dot-bracket 轻量检查任务时，按需使用 `./assets/bio_molecular_templates/` 与 `./assets/bio_molecular_tools/`
- 上游交接 comparative genomics、pathogen surveillance、phasing/imputation/PRS、phylogenetics、population genetics/GWAS、Newick tree QC 或 GWAS summary stats QC 时，按需使用 `./assets/bio_population_templates/` 与 `./assets/bio_population_tools/`
- 上游交接 segmentation、WSI tiling、flow cytometry panel、IMC analysis、image manifest、label mask、cytometry event table 或 marker intensity QC 时，按需使用 `./assets/bio_cell_imaging_templates/` 与 `./assets/bio_cell_imaging_tools/`
- 上游交接 feature matrix metadata、sample sheet、biomarker model card、causal genomics、variant prioritization、pharmacogenomics handoff、biomarker split leakage 或 ctDNA VAF panel QC 时，按需使用 `./assets/bio_table_templates/` 与 `./assets/bio_table_qc_tools/`
- 上游交接 blot quantification、liquid handling protocol 或 ELN/protocol record 时，按需使用 `./assets/bio_protocol_templates/`
- 上游交接 omics database query、regulatory annotation query 或可复现分析报告骨架时，按需使用 `./assets/bio_knowledge_templates/` 与 `./assets/bio_report_templates/`
- 上游交接实验室仪器 ASM 转换、展平、校验或 parser 导出任务时，按需使用 `./assets/bio_lab_quality_tools/`
- 确认索引后，只继续读取命中的具体卡片，避免一次性加载全部资料
- 需要精确生成 MACE/UMA 训练、微调、验证或推理参数时，先读对应 `*_parameter_policy.md`，再使用：
- 参数 Schema：`./assets/contracts/mace_parameter_schema.json` 或 `./assets/contracts/uma_parameter_schema.json`
- 生成器：`./assets/contracts/mace_config_builder.py` 或 `./assets/contracts/uma_hydra_override_builder.py`
- 校验器：`./assets/contracts/material_config_validator.py`
- 生成参数前必须先把数据探测、checkpoint 探测和任务类型整理成 JSON context；缺失高风险字段时让生成器失败，不要猜值。
## 设计与实现原则
- 优先复用已有组件、接口和目录结构
- 优先最小改动，不重写无关模块
- 明确哪些文件直接改、哪些只加适配层
- 如果上游已给出代码生成交接摘要，仅根据其中的设备适配、路径约束和入口要求实现代码
- 不要在本 skill 内部直接处理 Host、队列、module、conda 等硬件探测细节
- 如果任务本身就是“实现/修复代码”，可以在简短设计后直接进入编码，不必强制停在方案阶段
- 如果需求边界不清、改动范围大或风险高，再先输出方案并等待确认
## 链路续传原则
- 如果上游已明确传递 `required_chain=[onescience-coder, onescience-runtime]` 或 `final_execution_skill=onescience-runtime`，则当前任务在代码完成后仍未结束；必须继续把任务交接给 `onescience-runtime`
- 如果上游同时传递 `chain_continuation_required=true`，不要把“代码已完成”误判为“整条任务链已完成”
- 如果用户请求明确包含“跑一下”“提交”“验证运行”“SCnet”“SLURM”“下载日志”或其它执行信号，即使本轮主要工作是编码，也必须在输出中显式保留运行交接
## 验证原则
- 用户明确要求验证、测试、排查时，交给 `onescience-runtime` 的 `diagnose` 阶段；需要运行或日志证据时由 runtime 统一提交、同步和分类
- 不要把远程测试当成所有编码任务的前置门槛
- 没有执行证据时，不要声称“已验证通过”
+ ## 代码生成后 Review 原则
+
+ 代码生成后的 review 是静态需求一致性审查，不是运行校验、测试执行、日志排查或 debug。
+
+ 若上游交接包含 `coder_static_review_required=true`，静态 review 是代码生成完成前的硬性门槛；不能只说“建议 review”，也不能省略 review 结果直接结束。
+
+ 执行方式：
+
+ 1. 从用户原始需求、已确认的详细执行信息、上游交接摘要和读取过的契约卡片中提取需求清单。
+ 2. 逐条检查生成或修改的代码是否满足需求清单，至少覆盖：
+ - 参数与配置：要求的参数数量、名称、默认值、必填/可选关系是否完整，例如要求 9 个参数时不能只实现 8 个。
+ - 模型与结构：要求的主干、组件族和关键结构是否一致，例如要求 Swin Transformer 时不能实现成普通 CNN、MLP、vanilla Transformer 或其它结构。
+ - 输入输出协议：变量数、时间步、shape、batch 组织、返回字段和单位是否与需求一致。
+ - 数据与训练逻辑：样本构造、split、normalization、loss、rollout、metric、checkpoint 或配置入口是否覆盖需求。
+ - OneScience 复用：是否使用了已确认的 datapipe、模型卡、组件契约和最小适配路径。
+ - 文件落点与命名：新增文件、类名、函数名、注册名和 import 路径是否符合约定。
+ 3. 若发现偏差，必须先修改代码，使其重新对齐需求；不要只把偏差写进最终说明。
+ 4. 回改后再次做静态 review，直到没有已知需求偏差，或明确列出无法在当前信息下解决的阻塞项。
+ 5. 除非用户明确要求运行，否则不要为了 review 主动运行训练、推理、测试、下载数据或提交远程任务；这类执行验证仍交给 `onescience-runtime`。
+ 6. 最终输出必须包含 `静态需求一致性 review 结果` 小节，列出已核对项、已修正偏差和仍需确认项；缺少该小节时，不算完成代码生成。
+
## 输出要求
至少给出：
1. 问题理解
2. 可行性与复用点
3. 最小实现路径
4. 需要修改或新增的文件
如果进入编码阶段，再补充：
- 关键实现说明
- 尚未验证的风险点
+ - 静态需求一致性 review 结果：列出已核对的关键需求、发现并已修正的问题、仍未覆盖或需用户确认的项
如果上游已要求续传到 `onescience-runtime`，还必须补充：
- `next_action=onescience-runtime`
- `chain_continuation_required=true`
- `runtime_handoff`：至少包含本地脚本路径或入口文件、期望 `execution_mode`、`access_mode`、可选 `execution_channel`
- 若用户已授权执行、提交或验证运行，补充 `submission_authorized=true` 与 `authorization_scope`
## 禁止事项
- 不要在上游已指定 `onescience-coder -> onescience-runtime` 时，把代码完成误判为任务完成
- 不要在需要续传到 `runtime` 时省略 `next_action`、`chain_continuation_required` 或 `runtime_handoff`
## 文件落点
- 默认在当前项目目录下工作
- 只有当用户明确指定 `case` 目录时，才把生成文件固定写入 `case`