.github/ 是 Dovetailer 的协作入口层。这里的文件只负责 GitHub 上的 issue、PR、CI、标签和维护边界，不承载核心方法论资产。
| 文件 | 职责 |
|---|---|
workflows/ci.yml |
在 push 和 pull request 上运行格式、lint、类型、测试、卡片校验和构建。 |
ISSUE_TEMPLATE/bug_report.yml |
报告 CLI、schema、CI 或文档错误。 |
ISSUE_TEMPLATE/feature_request.yml |
提出新能力、流程或文档增强。 |
ISSUE_TEMPLATE/tool_card_submission.yml |
提交新的候选工具卡。 |
ISSUE_TEMPLATE/card_quality_review.yml |
请求去重、合并、重命名或正典晋升审查。 |
ISSUE_TEMPLATE/documentation.yml |
修正文档错误或补充仓库导航。 |
ISSUE_TEMPLATE/question.yml |
提问和讨论使用方式。 |
ISSUE_TEMPLATE/research_note.yml |
提交适合抽取工具卡的研究材料或方法论线索。 |
PULL_REQUEST_TEMPLATE.md |
PR 自检清单。 |
CODEOWNERS |
默认维护者和敏感目录审查边界。 |
dependabot.yml |
GitHub Actions 和 pip 依赖更新。 |
labels.yml |
建议标签体系，供维护者用 gh 或脚本同步。 |
标签不应该只是装饰。每个标签都要帮助维护者判断：
- 这是什么类型的工作。
- 它影响哪一层。
- 它当前处于什么状态。
- 它是否需要正典晋升、严格校验或架构判断。
- 修改 CI、模板或标签时，应同步检查 CONTRIBUTING.md 与 docs/quality-gates.md。
- 修改 issue/PR 流程时，应保证新贡献者仍能在 5 分钟内找到入口。
- 新增自动化前，优先使用 GitHub 原生能力或成熟 action；避免为了展示感引入脆弱流程。