该技能面向希望为 nüwa 仓库本身做贡献的开发者,而不是使用 nüwa 工具。其核心目的是帮助贡献者提交符合规则的 PR 或 issue,并明确不同贡献类型的处理路径。
用途:
- 修复 scripts/ 下的脚本,需附带重现步骤,可直接提 PR。
- 翻译 README 或修正拼写错误,可直接提 PR。
- 发现方法论问题或改进想法,应开 issue,而非直接修改 SKILL.md;被采纳后由维护者写入并在 commit 中致谢。
- 贡献衍生工具、集合或编排,需在 COMMUNITY.md 中添加一行并提 PR。
- 个人 persona 技能不应放入 examples/,应参考 07 号指引。
主要能力:
- 提供环境搭建说明:无需构建步骤、包管理器或 requirements.txt,仅需 Python 3(3.9+,因代码使用 list[str] 类型提示)和 yt-dlp(用于一个脚本)。
- 给出运行现有检查的命令示例,包括 merge_research.py、quality_check.py、srt_to_transcript.py 的预期输出和退出码,以及遍历所有示例的循环脚本。
- 说明社区 PR 的本地检查方式:使用 GITHUB_TOKEN 和 --check-repo 参数运行 community_check.py;警告不要本地运行 CI 模式(需要 GITHUB_TOKEN、GITHUB_REPOSITORY、PR_NUMBER 并会发布 PR 评论)。
- 强调修改 workflow 时的安全注意事项:使用 pull_request_target 且仅 checkout main 上的脚本,不得 checkout 或运行 PR 代码,否则构成权限漏洞。
- 提供 PR 前检查清单:不修改 SKILL.md、无 .DS_Store 等垃圾文件、一个 PR 只做一件事、PR 描述需说明做什么、为什么、如何验证。
- 列出可贡献的未完成事项:download_subtitles.sh 中中文分支因 /tmp/.ytdlp_marker 未创建而永远失败;merge_research.py 仅支持 references/research/01-06.md,而 5/15 示例使用扁平文件;quality_check.py 用正则计数“诚实边界”列表项,段落或表格形式会被判 0 分。
使用方式: 通过 SHELL 命令和 GitHub 操作完成。先克隆仓库,检查 Python 版本,安装 yt-dlp(如需要),然后运行示例检查脚本验证环境。提交前按清单自查。
适用场景: 适合希望改进 nüwa 工具本身(脚本、文档、方法论)的贡献者,不适用于仅想使用 nüwa 工具的用户。
限制:
- SKILL.md 为核心资产,不接受外部 PR。
- 仓库无测试套件,验证依赖运行示例脚本。
- 部分脚本存在已知问题(如 download_subtitles.sh 死分支、merge_research.py 结构限制、quality_check.py 计数偏差),需贡献者注意或修复。
- CI 模式不应用于本地。