xas-skills/AGENTS.md

仓库协作约定

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 验证；报告无法执行的环境与原因。
• 未经实际验证，不得声称远端已经发布或端到端更新验收完成。