3.2 KiB
3.2 KiB
贡献指南 / Contributing
感谢你想为女娲生态出力。先读这一页,能帮你的贡献走对路,也能省掉双方的往返。
一条核心规则
SKILL.md 是本仓库的核心资产,不接受外部PR改动。 女娲方法论的每一行都经过维护者的实测验证和版本化优化(见darwin-skill流程),任何对它的修改只由维护者本人完成。
这不是拒绝你的想法——如果你发现了方法论的bug或改进点,开issue讨论。被采纳的想法会由维护者写进SKILL.md,并在commit中致谢你(先例:PR #59发现的description超限bug已按此方式采纳)。
贡献人物Skill:走社区索引,不走examples/
examples/ 是维护者出品的官方示范,保持统一的质量口径。社区蒸馏的人物skill走这条路:
- 放进你自己的GitHub仓库(一个skill一个仓库,star和维护权都归你)
- 跑一遍保真度评分(见 references/fidelity-scorecard.md),在仓库里放一份
FIDELITY.md - 提PR把你的仓库链接加进 COMMUNITY.md,一行搞定
这对你更划算:你的作品有自己的门牌和star数,还能持续迭代不受本仓库节奏限制。
收录COMMUNITY.md的门槛
- 用女娲流程蒸馏,仓库内含
references/research/调研底稿(自包含,可溯源) - 有「诚实边界」和「反模式」章节
- 保真度评分卡 ≥ B(70分),仓库根目录放
FIDELITY.md - 通过伦理红线检查(见下)
提交收录PR后,机器人会自动检查以上形式门槛并把✅/❌清单贴成评论(改完推送会自动重跑);机器检查通过后,维护者人工确认伦理红线和内容质量即可合并。
伦理红线(不收录,也请不要提交)
- 未经本人同意蒸馏在世的非公众人物(同事、前任、普通人)
- 用于冒充、骚扰、诈骗场景的skill
- 医疗、法律、投资等高责任领域的skill,若无明确免责声明和「不能替代专业人士」边界
其他贡献类型
| 类型 | 怎么提 |
|---|---|
| 方法论bug/改进想法 | 开issue讨论(不要直接PR改SKILL.md) |
| scripts/工具脚本修复 | 直接PR,说明复现步骤 |
| README翻译/文档错别字 | 直接PR |
| 衍生工具/合集/编排项目 | 提PR加进COMMUNITY.md |
PR Checklist
- 没有改动
SKILL.md - 没有
.DS_Store等垃圾文件 - 一个PR只做一件事(不要多个人物打包)
- PR描述说清楚:做了什么、为什么、怎么验证的
English Summary
SKILL.mdis the core asset and does not accept external PRs. Found a bug or improvement? Open an issue — adopted ideas are implemented by the maintainer with credit in the commit.- Persona skills go to the community index, not
examples/: host the skill in your own repo (you keep the stars), run the fidelity scorecard (grade B or above), then PR a one-line entry to COMMUNITY.md. - Ethics: no distilling living private individuals without consent; no impersonation/harassment use cases; medical/legal/financial personas need explicit disclaimers.