ellmos-ai 中文 —
github-repo-care官方中文版本。
GitHub Repo Care — 规范发布与维护 GitHub 仓库 (中文)
适用场景
当需要创建、发布、Release、审计或维护 GitHub 仓库时使用本 Skill。在首次公开推送 (public push)、Release 标签、仓库元数据、组织 Profile 和隐私检查前尤为重要。
请勿在没有 GitHub 发布步骤的纯代码实现工作中直接使用。请先完成相关的开发或调试工作流，然后再激活本 Skill 进行发布。
核心原则
在首次公开推送前准备好仓库。在公开提交历史产生之前，配置好正确的 .gitignore、隐私门禁 (privacy gate)、许可证 (license)、README、元数据和 Release 描述，成本要低得多。
工作流程与步骤
- 读取本地规则。 检查是否存在
AGENTS.md、CLAUDE.md、START.md、Release 策略、命名策略和锁策略。 - 检查锁文件。 若
LOCK.txt或匹配的LOCK.*.txt处于激活状态，请勿编辑该作用域。 - 确定仓库标识。 确认名称、组织、可见性、许可证以及一句话的项目宗旨。
- 在
git add前创建.gitignore。 排除密钥、本地数据、数据库、构建输出、虚拟环境、缓存、IDE 文件和私有笔记。 - 添加公共基础文件。 典型文件：
README.md、LICENSE、CHANGELOG.md、SECURITY.md、CONTRIBUTING.md、CODE_OF_CONDUCT.md、llms.txt和 CI。 - 撰写易于发现的 README。 首屏内容：项目宗旨、安装步骤、使用方法、隐私模型、项目布局、许可证和规范仓库名称。
- 添加视觉标识。 当横幅 (banner)、Logo 或截图有助于更容易理解项目时请予以添加。当可以提供真实的产品截图或清晰的概念图时，避免使用通用的装饰性图片。
- 从一开始妥善规划 i18n。 最低要求：英语 + 项目语言。面向用户的模块首选标准语言集：德语、英语、西班牙语、简体中文、日语和俄语。
- 运行测试和冒烟测试 (smokes)。 在宣称成功或创建 Release 前在本地进行验证。
- 运行隐私门禁检查。 检查暂存/追踪的文件集 (staged/tracked)，确保无密钥、本地路径、个人隐私信息 (PII)、
.env、数据库、私有文档、生成的产物和乱码 (mojibake)。 - 提交并推送。 仅在通过门禁检查后才进行 Commit。然后创建或关联 GitHub 仓库、Push 并验证远程状态。
- 设置元数据。 检查 description、topics、homepage、visibility 和默认分支。
- 创建 Release。 创建 Tag 和 GitHub release；验证分支与 Tag 的 CI 状态。
- 更新入口与检索表面。 从组织 Profile、
llms.txt、中央注册表、本地模块索引和生态 README 中添加链接。 - 最终验证。 检查远程 README、Release 页面、Topics、CI 和链接。
隐私门禁 (Privacy Gate)
检索暂存或已追踪的文件集，而不仅仅是可见的工作区树。
git diff --cached --check
git ls-files
rg -n "C:\\\\Us[e]rs\\\\|C:/Us[e]rs/|/c/Us[e]rs/|s[k]-[A-Za-z0-9]|gh[p]_|gh[o]_|API[_-]?KEY|TO[K]EN|PASS[W]ORD|SEC[R]ET|\\x{C3}|\\x{C2}|\\x{FFFD}" .
对于公开模块，还需记录 RELEASE_GATE.md 或同等的门禁文档：日期、已检查的命令、结果、剩余警告和有意保留的例外。如果曾经提交过密钥，仅从 HEAD 删除是不够的；必须轮换 (rotate) 该密钥。
GitHub 元数据
推送之后，显式设置元数据与 Release 数据。
gh repo edit ORG/REPO --description "Short concrete description" \
--add-topic local-first --add-topic python --add-topic llm
git tag -a v1.0.0 -m "v1.0.0"
git push origin v1.0.0
gh release create v1.0.0 --repo ORG/REPO --title "v1.0.0" --notes "..."
然后进行验证：
gh repo view ORG/REPO --json nameWithOwner,visibility,description,repositoryTopics,url
gh release view v1.0.0 --repo ORG/REPO --json tagName,url,isDraft,isPrerelease
gh run list --repo ORG/REPO --limit 5
如果 Release 后 CI 报错 (显示红色)，说明仓库尚未规范发布。对于刚创建的初始 Release，立即且有针对性地将新 Tag 移动到修正后的 Commit 是可以接受的。
常见错误
| 错误 | 修复方案 |
|---|---|
在 git add 之后才添加 .gitignore |
先取消暂存 (unstage)，修复忽略规则，然后重新 add |
| 界面或 Skill 为多语言，但 README 仅有单一语言 | 添加语言链接或多语言本地化 README |
| 缺少 Banner、Topics 或 Description | 在对外发布前补充入口与展示资产 |
| 存在 Release tag，但 CI 报错 (显示红色) | 修复 CI 并验证新的运行结果 |
更新了组织 README，但遗漏了 llms.txt |
同时更新人类可读与机器可读的展示表面 |
| 公开文档中出现了本地路径 | 替换为相对路径或通用示例 |
| 公开仓库中包含测试数据库或 Notebook 收件箱 (inbox) | 将其从版本追踪中移除，添加忽略规则，重新运行门禁检查 |
最终检查清单
- 已检查本地规则与锁文件。
- 首次 add 前已存在
.gitignore。 - 已提供公共文档、LICENSE、SECURITY、CONTRIBUTING、CHANGELOG 和
llms.txt。 - README 包含仓库名称、项目宗旨、安装步骤、使用方法、隐私说明及许可证。
- 满足 i18n 预期。
- 在有用时提供了 Banner、Logo 或截图。
- 测试与冒烟测试通过。
- 隐私、路径、密钥、数据库及乱码扫描干净。
- GitHub Description、Topics、Tag、Release 及 CI 已验证。
- 组织 Profile、注册表及生态系统链接已更新。
变更日志
1.0.0 (2026-06-18)
- 创建初始仓库维护与发布规范协议。