59 lines
3.2 KiB
Markdown
59 lines
3.2 KiB
Markdown
# 贡献指南 / 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](references/fidelity-scorecard.md)），在仓库里放一份 `FIDELITY.md`
|
||
3. **提PR把你的仓库链接加进 [COMMUNITY.md](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.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](references/fidelity-scorecard.md) (grade B or above), then PR a one-line entry to [COMMUNITY.md](COMMUNITY.md).
|
||
- **Ethics**: no distilling living private individuals without consent; no impersonation/harassment use cases; medical/legal/financial personas need explicit disclaimers.
|