Easyuseaide public repository release

公开代码仓库发布

将公开发布视为安全边界。未经用户明确授权，不创建公开仓库、不修改可见性、不推送、不发布版本。

已有框架可以继续负责测试、评审、分支合并和普通任务收尾。本 Skill 只接管公开边界检查及实际发布核验，并直接复用已经完成且仍适用的测试、评审和构建证据。

1. 确认发布目标

确认：

• 代码托管账户或组织；
• 仓库名称；
• 私有还是公开；
• 默认分支；
• 本次推送范围；
• 是否包含 Tag、Release 或构建制品；
• 用户是否明确授权外部写操作。

2. 确认公开文件集合

• 检查工作区状态、忽略规则和实际已跟踪文件；
• 不直接上传或扫描整个本地目录；
• 不读取或发布与公开集合无关的本机数据。

不得公开：

• .env 和真实配置；
• Token、Cookie、密码、私钥和证书；
• 数据库、备份、日志和运行数据；
• 聊天记录和个人工作区数据；
• 本机绝对路径和内部系统地址；
• 未获授权的第三方代码或资料。

示例只能使用明确匿名占位值，不使用截短或轻微修改的真实凭据。

先使用 Git 命令确认准备公开的文件，不依赖目录遍历猜测：

git status --short
git ls-files
git diff --cached --name-status

如果公开范围是当前 Git 索引中的完整文件集合，使用独立临时目录导出索引内容，再扫描该目录：

public_scan_dir="$(mktemp -d)"
git checkout-index --all --prefix="$public_scan_dir/"
gitleaks dir -v --redact "$public_scan_dir"

git checkout-index 导出的是索引中的文件，不包含普通未跟踪文件和被忽略文件。执行前仍应检查子模块、Git LFS、生成制品和符号链接等特殊内容是否需要单独处理。

临时目录只有在路径已解析、确认为本次创建且不为空时才可清理；无法确认时保留并报告位置，不执行递归删除。

只有用户明确要求把整个工作目录作为公开候选，且已经确认被忽略文件和运行数据不会被读取时，才对工作目录直接运行 gitleaks dir。

3. 安全检查

对准备公开的文件以及全部可达版本历史执行敏感信息扫描。

执行前确认已安装版本和命令帮助：

gitleaks version
gitleaks git --help
gitleaks dir --help

扫描精确导出的公开文件集合：

gitleaks dir -v --redact "$public_scan_dir"

扫描本地全部可达 Git 历史：

gitleaks git -v --redact --log-opts="--all" .

本地 --all 只覆盖本地已有引用。需要声称远端全部可达历史已扫描时，应先在授权范围内获取并确认远端分支和 Tag，或使用全新克隆执行扫描。

• 工具未安装、命令失败或扫描范围不完整时，不得声称已通过敏感信息检查；
• 输出中不得回显真实密钥；
• 发现敏感内容后先停止发布；
• 历史中存在敏感内容时，使用 easyuseaide-high-risk-git-operation Skill 处理。

同时检查：

• 开源许可证；
• 第三方许可证；
• README 中的安装与测试命令；
• CI 是否引用真实密钥；
• 示例配置是否安全；
• 是否包含不应公开的内部名称或业务信息。

4. 提交与推送

• 查看完整差异；
• 提交仅包含本次公开范围；
• 不把无关修改混入；
• 推送前再次确认远端、分支和可见性；
• 不使用普通强制推送；
• 外部写操作遵循当前工具的授权和审批机制。

5. 远端验证

推送后验证：

• 远端文件树；
• 仓库可见性；
• 默认分支；
• README 渲染；
• CI 状态；
• Tag、Release 或制品；
• 是否意外出现敏感文件。

不得仅依据本地提交或推送返回成功判断发布完成。

将当前发布版本、Tag、Release、CI 结果、日期和证据链接更新到项目现有的单一状态源，EasyUseAIDE 项目默认使用 docs/project-status.md。发布与回滚 Runbook 只保存稳定流程，不得复制这些动态状态，避免下次发布后出现文档漂移。

6. 交付报告

说明实际公开内容、仓库与分支、安全检查范围与结果、CI 和远端复核结果、未验证内容和剩余风险。