jos-artifact-evaluation
GitHub指导作者在《软件学报》投稿时恰当准备代码与数据。鉴于无强制评审轨道,建议将可复现材料作为加分项,提供稳定链接、环境说明及开源许可,避免照搬国际会议徽章流程,并按成熟度分级准备,同时注意专刊特殊要求与合规性。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill jos-artifact-evaluation -g -y
SKILL.md
Frontmatter
{
"name": "jos-artifact-evaluation",
"description": "当你要判断《软件学报》(Journal of Software, JOS) 对代码与数据可用性(artifact)的现状与要求、并据此准备可评估材料时使用。覆盖本刊尚无强制 artifact 评审轨道的现实、如何把可复现材料做成加分项、专刊(special issue)与 CCF ChinaSoft 联动可能带来的材料要求、归档与许可选择、以及与国际会议 artifact badging 的差异,帮助你在《软件学报》(Journal of Software) 语境下做出恰当而不过度的 artifact 准备。"
}
《软件学报》代码与数据可用性 (Journal of Software Artifact Evaluation)
本技能澄清《软件学报》(Journal of Software, JOS) 对 artifact(代码/数据可用性)的现状,
并给出恰当准备。与 ACM/IEEE 国际会议不同,本刊目前没有公开的强制 artifact 评审轨道与
徽章体系(现状 待核实,见
resources/official-source-map.md);因此这里的目标
是"把可复现材料做成加分项",而非套用国际会议的 badging 流程。
一、现状:无强制轨道,但可用性是加分
- 本刊未见公开的独立 artifact evaluation track 或"Available/Reusable"徽章制度。
- 但提供可访问、可复现的代码/数据,能显著增强审稿人对结果的信任(见
jos-reproducibility)。 - 因此策略是:主动、恰当地提供材料,而非等待强制要求。
二、把可复现材料做成加分项
- 在论文中给出清晰的可用性声明与稳定链接,而非"可根据要求提供"。
- 材料附 README,能从零复现主要表/图;提供环境(容器/依赖清单)。
- 若涉及隐私/版权无法公开,给出脱敏样本、合成数据或评测协议作替代。
三、专刊与 ChinaSoft 联动的可能要求
- 部分专刊(special issue)由特约(客座)编辑组稿,可能对材料、评测协议提出额外要求。
- 与 CCF ChinaSoft 中国软件大会联动的专刊,可能要求先作口头报告或提交演示材料。
- 投专刊前,到专刊征稿页核对是否有代码/数据、演示、评测方面的具体要求。
四、归档与许可选择
[ ] 代码托管:稳定仓库(含发布 tag / commit 固定)
[ ] 大数据/大文件:归档平台(Zenodo/校内镜像)+ DOI 或稳定链接 + 校验和
[ ] 许可:开源许可(如 MIT/Apache-2.0/GPL 视情况),数据许可单独声明
[ ] 合法性:确认可分享(无版权/隐私问题),必要时脱敏
五、与国际会议 artifact badging 的差异
| 维度 | 国际会议(ACM/IEEE) | 《软件学报》现状 |
|---|---|---|
| 评审轨道 | 独立 AE track | 无公开强制轨道(待核实) |
| 徽章 | Available/Functional/Reusable/Reproduced | 无公开徽章体系 |
| 时机 | 录用后单独截稿 | 无固定 AE 截稿 |
| 定位 | 影响正式认定 | 增强说服力的加分项 |
不要把国际会议的 badging 术语与流程照搬进本刊投稿,避免误导。
六、准备自检清单
[ ] 已确认本刊/目标专刊对 artifact 的当前要求(到官网/征稿页核对)
[ ] 论文有可用性声明与稳定链接(非"可根据要求提供")
[ ] 材料含 README,可从零复现主要结果
[ ] 环境已固定(容器/依赖清单)
[ ] 归档渠道与许可已定,材料合法可分享
[ ] 若投专刊:核对演示/评测/材料的额外要求
七、输出格式
【artifact 策略】恰当提供(加分)/ 专刊要求驱动 / 暂不公开(给替代)
【本刊现状】无公开强制轨道(待核实,以官网为准)
【可用性声明】链接是否稳定:________
【专刊要求】是否有额外材料/演示要求:________
【归档与许可】方案:________
【下一步】用 jos-reproducibility 打磨材料 / 用 jos-supplementary 组织附录
八、材料成熟度分级(自评你的可用性到了哪一档)
为避免"要么不给、要么过度工程化",把材料成熟度分成几档,按投稿目标选择合适的一档,不必 一步到位追求国际会议 Reusable 级别:
- 第 0 档 只有声明:论文仅写"可根据要求提供"。这是弱项,审稿人无法核验,尽量避免。
- 第 1 档 可见:提供公开仓库链接,代码与关键脚本可读,但复现步骤不完整。适合快速加分。
- 第 2 档 可复现:附 README、环境说明与一键脚本,第三方能重复主要表/图。这是本刊语境下 性价比最高、最值得追求的一档。
- 第 3 档 可复用:文档完善、接口清晰、他人能在自己的数据上复用你的方法。适合方法类、 工具类论文,也便于后续被引用与二次开发。
对多数投向《软件学报》(Journal of Software) 的研究论文,达到第 2 档即可显著增强说服力; 方法/工具类或计划开源推广的工作可争取第 3 档。综述类论文若含分类基准或数据集,也可提供 数据侧材料。
九、与出版流程的衔接
- 录用后定稿阶段(见
jos-camera-ready)确认材料链接在见刊 时仍然稳定有效,避免"论文见刊、链接失效"。 - 若材料随论文以补充材料形式提交,其组织与正文引用见
jos-supplementary。 - 归档时优先使用能长期保存并提供稳定标识(DOI)的平台,减少链接腐烂风险。
十、常见误区
- 照搬 ACM/IEEE 徽章术语,声称本刊有 AE track——现状并非如此,属 待核实 需核对。
- 只写"可根据要求提供",停留在第 0 档,错失加分。
- 忽略专刊的额外材料要求,投稿后才发现。
- 上传含版权/隐私数据的材料,带来合规风险。
- 为追求"可复用"过度工程化,反而拖延投稿——按目标选合适档位即可。
十一、输出格式
【材料档位】第0档声明 / 第1档可见 / 第2档可复现 / 第3档可复用
【本刊/专刊要求】已核对官网与征稿页:________(现状待核实)
【归档许可】平台与许可:________
【与出版衔接】见刊时链接是否稳定:________
【下一步】用 jos-reproducibility 补齐到第2档 / 用 jos-supplementary 组织提交
综上,在《软件学报》(Journal of Software) 语境下,对 artifact 的正确态度是"主动提供、恰到 好处、合法可分享":既不因为无强制要求而完全不给,也不照搬国际会议的重型 badging 流程徒增 负担。把可复现材料做扎实,本身就是对软件学科研究诚信的体现。
提醒:本刊是否新增 artifact 政策、专刊具体要求,均属 待核实,请以《软件学报》(Journal of Software) 官网投稿指南与 CCF ChinaSoft 专刊征稿页为准。工具适配见
resources/code/README.md。
Version History
- 9f86f09 Current 2026-07-19 16:50


