# 仓库协作约定

## Git 操作需要明确授权

除非用户在当前对话中明确要求，否则不得执行 `git commit`、修改提交、创建标签、推送或以其他方式创建 Git 历史。

实现完成后保留未暂存修改；只有用户明确要求时才暂存。交付修改文件、验证结果与未完成的验收项，等待用户审阅。用户允许实现功能不等于允许提交或推送。

## 实现与验证

- 正式技能放在 `skills/`，模板放在 `templates/`；每个技能保持自包含，不引入作者机器上的绝对路径或凭据。
- 安装与更新工具兼容 Windows PowerShell 5.1 和 PowerShell 7，不要求使用者安装额外运行时或 PowerShell 模块。
- PowerShell 文件采用 UTF-8 with BOM，Markdown 采用 UTF-8 without BOM；遵循 `.gitattributes` 的换行约定。
- 安装器不得覆盖非本仓库管理的同名技能或用户修改，不增加强制覆盖选项。更新只允许快进，不自动卸载上游删除的技能。
- 文件操作测试使用临时目录，不写入真实个人技能目录。Git 流程使用模拟结果验证，不通过创建临时提交或推送来测试。
- 同时运行 `tests/Test-Install.ps1` 和 `tests/Test-Update.ps1` 的 PowerShell 5.1/7 验证；报告无法执行的环境与原因。
- 未经实际验证，不得声称远端已经发布或端到端更新验收完成。