团队约定

贡献规矩

• 改了某 skill 的共享内容，必须同时 bump 它的 metadata.version 再 push/PR，否则别人 sync 时被版本门控挡住。
• 消费者本地别 push；私货放 *.local.md、local/、.skillsrc。
• 维护提交、beta 版本、CHANGELOG 口径见仓库 CONTRIBUTING.md。

共享 vs 本地

类型	内容	规则
共享	SKILL.md、references/、scripts/	仓管理，改它=打算上游
本地	*.local.md、local/、.skillsrc	.gitignore，永不推送、永不覆盖

文档与提交

• 规范、需求缺陷、交付文档、提交信息规范：走 hai-spec skill。
• 密钥、token、机器路径一律进 .skillsrc，不写进仓库文件，也不写进 Wiki。