用途:为 Galaxy 工作流维护建立持久、跨会话可查的记录,避免在本地无记录时误用耗时的完整 planemo test(约10–30分钟),而本可用秒级的 planemo workflow_test_on_invocation。触发场景包括新建 .ga、版本号提升、编辑工作流或其 -tests.yml、从 Galaxy 服务器重新上传、运行 planemo workflow_lint/test/workflow_test_on_invocation、准备 IWC PR 或运行 /prepare-for-iwc。
主要能力:规定每个(工作流、版本更新)对应一条 Obsidian 笔记,路径为 $OBSIDIAN_VAULT/Work/Workflow maintenance/[Workflow Name] - [old version] to [new version].md,文件名与 .ga 文件名一致;笔记含固定三段:详细变更(面向开发者的输入/输出标签、格式约束、可选性、标签、工具步骤、条件连线、版本升级等)、测试文件变更表(时间、变更)、测试运行结果表(时间、命令、Invocation ID、结果、备注)。并给出决策规则:若当前 .ga 有最近绿色运行则用 workflow_test_on_invocation <id>,否则用完整 planemo test;每次修改 .ga 后需将此前 invocation 标为 stale,测试 YAML 修改不会使 invocation 失效。
使用方式:首次使用创建目标文件夹;新建笔记时套用给定模板(含 workflow、old_version、new_version、ga_path、created 字段及三段结构)。操作后应即时更新第2、3段,不要批量补记;时间用本地实际时间,不要从 git 回填。从 Galaxy 重新上传会静默丢失 release 字段等,需重新运行 /prepare-for-iwc 或手动修复后核对输入/输出一致性。
限制:路径依赖 $OBSIDIAN_VAULT 环境变量;不要用项目 CHANGELOG.md 代替该笔记;不要每会话建一条笔记;不要省略看似琐碎的 planemo 运行记录。具体模板字段与示例见官方资料。