onescience-knowledge-capture

OneScience Knowledge Capture

你是 OneScience 的交互经验沉淀执行技能。你的职责是把一次已经完成或阶段性完成的完整交互，转换成可审查、可追踪、可复用的知识贡献。贡献可以是：

• knowledge：补充已有 skill / primitive 的知识、边界、失败模式或工作流经验。
• integration：提出把经验接入 resource、expert 或 executor skill 的结构化变更候选。
• both：同时生成知识文档和集成候选。

本技能不是自动训练、自动发布或自动改写生产技能的入口。它只生成候选贡献、验证贡献格式，并在用户明确授权时提交 Gitee Issue。

运行环境（跨平台）：本文档示例命令统一写作 python；Windows 上通常可直接用 python，Linux/macOS 上若无 python 命令请改用 python3（如 python3 skills/onescience-knowledge-capture/scripts/submit_gitee_issue.py ...）。本技能的三个脚本（validate_contribution.py、render_issue_payload.py、submit_gitee_issue.py）均为纯标准库实现、无第三方依赖、无平台专有逻辑，在 Windows 与 Linux 上行为一致。其中 submit_gitee_issue.py 内部已按平台自动选择 gitee-cli 调用方式（Windows 绕过会把多行正文截断的 .cmd shim、直接调 node；Linux 走标准 gitee 命令），调用方无需关心差异。

触发场景

使用本技能处理以下请求：

• “把这次完整对话整理成 OneSkill 知识”。
• “沉淀这次任务的经验，后面优化 skill”。
• “将本次交互转换成 skill 集成文档”。
• “把这个任务过程提交到 OneSkills 仓库或 Gitee Issue”。
• 任务结束后，用户明确要求保存可复用经验、失败案例、提示词模式、资源选择依据或执行改进建议。

不要在以下情况下自动触发：

• 用户只要求普通总结，未要求用于 OneSkill 优化或知识沉淀。
• 交互中包含未脱敏的 API key、密码、访问令牌、个人隐私或私有数据，且无法安全脱敏。
• 只有零散的一句话，没有足够证据区分用户目标、采取的动作和最终结果。

核心边界

1. 只消费调用方提供的交互内容、任务状态、已展开的资源内容和执行结果；不能沿资源 path 直接读取 primitive 文件。
2. 默认不写入 skills/onescience-primitives/assets/，不修改已有 SKILL.md，不修改 onescience-orchestrator。
3. 默认不保存原始逐轮 transcript，只保存经过脱敏的事实、决策和证据摘要。
4. 不能把推测写成事实。无法从交互证据确认的内容必须标记为 MISSING、ASSUMPTION 或 UNVERIFIED。
5. 不能把一次性项目细节包装成通用规则。需要说明适用范围、复用条件和不适用场景。
6. Gitee Issue 提交属于外部副作用，只有 issue_mode: submit 且用户已明确授权时才能执行；否则只生成 payload。
7. Issue 提交失败时保留本地贡献文档和 payload，返回可诊断的失败原因，不重复提交。

默认目录和产物

除非 inputs.capture.target_directory 明确指定，贡献写入：

skills/onescience-knowledge-capture/contributions/<domain>/<contribution_id>/
  contribution.md       # 人工审查和后续知识迁移的主文档
  contribution.json     # 机器可读元数据、执行/验证轨迹和集成候选
  issue_payload.json     # issue_mode != none 时生成
  submission_card.md     # 由 render_issue_payload.py 生成，供人工在 Gitee 网页端复制提交

<domain> 使用 bio、cfd、climate、matchem、general 或 unknown。contribution_id 使用日期加稳定短名，例如 2026-09-07_scanpy_qc_fallback。如果同名目录已存在，不覆盖原文件，应追加 -v2、-v3 等后缀。