CONTRIBUTING.md 3.0 KB

贡献指南 / Contributing

感谢你想为女娲生态出力。先读这一页,能帮你的贡献走对路,也能省掉双方的往返。

一条核心规则

SKILL.md 是本仓库的核心资产,不接受外部PR改动。 女娲方法论的每一行都经过维护者的实测验证和版本化优化(见darwin-skill流程),任何对它的修改只由维护者本人完成。

这不是拒绝你的想法——如果你发现了方法论的bug或改进点,开issue讨论。被采纳的想法会由维护者写进SKILL.md,并在commit中致谢你(先例:PR #59发现的description超限bug已按此方式采纳)。

贡献人物Skill:走社区索引,不走examples/

examples/ 是维护者出品的官方示范,保持统一的质量口径。社区蒸馏的人物skill走这条路:

  1. 放进你自己的GitHub仓库(一个skill一个仓库,star和维护权都归你)
  2. 跑一遍保真度评分(见 references/fidelity-scorecard.md),在仓库里放一份 FIDELITY.md
  3. 提PR把你的仓库链接加进 COMMUNITY.md,一行搞定

这对你更划算:你的作品有自己的门牌和star数,还能持续迭代不受本仓库节奏限制。

收录COMMUNITY.md的门槛

  • 用女娲流程蒸馏,仓库内含 references/research/ 调研底稿(自包含,可溯源)
  • 有「诚实边界」和「反模式」章节
  • 保真度评分卡 ≥ B(70分)
  • 通过伦理红线检查(见下)

伦理红线(不收录,也请不要提交)

  • 未经本人同意蒸馏在世的非公众人物(同事、前任、普通人)
  • 用于冒充、骚扰、诈骗场景的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.md is 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.