18 lines
1.4 KiB
Markdown
18 lines
1.4 KiB
Markdown
# 仓库协作约定
|
||
|
||
## 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 验证；报告无法执行的环境与原因。
|
||
- 未经实际验证，不得声称远端已经发布或端到端更新验收完成。
|