Skill 怎么分享给同事：打包、校验、安装与恢复旧版本

release-kit/
  meeting-notes/
    SKILL.md
    VERSION
    README.md
    CHANGELOG.md
    tests/
      cases.json

1.0.0

# 变更记录

## 1.0.0
- 首个教学版本：将提供的会议原文整理为决定、待办、待确认。
- 负责人/期限不推断；冲突并列；依据保留原文行号。
- 无脚本、无联网、无第三方依赖；默认只在对话返回结果。
- 本文件不宣称已在某一客户端或操作系统上实测。

# meeting-notes 1.0.0

用途：整理用户在本次请求提供的会议文字。
文件：SKILL.md、VERSION、CHANGELOG.md、tests/cases.json。
无 Node/Python/API Key/MCP 依赖；没有安装脚本。

本地 Codex 安装：审读文件后，把整个 meeting-notes 文件夹复制到
仓库 .agents/skills/ 或用户 ~/.agents/skills/，选一个范围。
Windows 原生用户路径为 %USERPROFILE%/.agents/skills/。
已经有同名文件夹时先比较和归档，不能直接覆盖。

验证：检查发现路径，显式调用 $meeting-notes，再跑 tests/cases.json。
测试状态：教学包尚无客户端运行记录；不要填“已支持所有平台”。
如有真实测试，另记客户端版本、系统、模型、路径、用例与输出。

停用：在 Codex 配置中按 SKILL.md 绝对路径禁用并重启。
卸载：先将目标文件夹移出可发现目录；保留包与校验值。
历史会议输入和输出不属于 Skill 程序文件，不要随卸载删除。

其他产品：本文包未验证 Claude Code、Cursor 或 ChatGPT 工作区安装。
不得用本页 Codex 路径替代其各自安装规则。

$releaseRoot = Join-Path (Get-Location) 'release-kit'
$packageDir = Join-Path $releaseRoot 'meeting-notes'
$archive = Join-Path $releaseRoot 'meeting-notes-1.0.0.zip'
$required = @('SKILL.md', 'VERSION', 'README.md', 'CHANGELOG.md', 'tests\cases.json')
foreach ($relative in $required) {
  if (-not (Test-Path -LiteralPath (Join-Path $packageDir $relative) -PathType Leaf)) {
    throw ('缺少发布文件：' + $relative)
  }
}
$version = (Get-Content -LiteralPath (Join-Path $packageDir 'VERSION') -Raw).Trim()
if ($version -ne '1.0.0') { throw '版本号与包名不一致' }
if (Test-Path -LiteralPath $archive) { throw '已有同名包，请先确认版本，不覆盖' }
Get-ChildItem -LiteralPath $packageDir -File -Recurse | Select-Object FullName, Length
Compress-Archive -LiteralPath $packageDir -DestinationPath $archive
$hash = (Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash
[IO.File]::WriteAllText($archive + '.sha256', $hash + [Environment]::NewLine)
Write-Output $hash

$archive = Join-Path (Get-Location) 'meeting-notes-1.0.0.zip'
# 可信发布渠道给出的哈希保存为同目录 expected.sha256。
$expected = (Get-Content -LiteralPath 'expected.sha256' -Raw).Trim()
$actual = (Get-FileHash -LiteralPath $archive -Algorithm SHA256).Hash
if ($expected -notmatch '^[0-9a-fA-F]{64}$' -or $actual -ne $expected) {
  throw '哈希不匹配或格式不正确，停止安装'
}
$staging = Join-Path (Get-Location) '_skill-staging\meeting-notes-1.0.0'
if (Test-Path -LiteralPath $staging) { throw '暂存目录已存在，请先核对旧内容' }
Expand-Archive -LiteralPath $archive -DestinationPath $staging
$source = Join-Path $staging 'meeting-notes'
Get-Content -LiteralPath (Join-Path $source 'SKILL.md') -Raw
Get-ChildItem -LiteralPath $source -Force -Recurse | Select-Object FullName, Length

$repoResult = git rev-parse --show-toplevel
if ($LASTEXITCODE -ne 0 -or -not $repoResult) { throw '请进入要安装的 Git 仓库' }
$repoRoot = ([string]$repoResult).Trim()
$target = Join-Path $repoRoot '.agents\skills\meeting-notes'
if (Test-Path -LiteralPath $target) { throw '已有安装，请先归档并比较版本' }
New-Item -ItemType Directory -Path (Split-Path -Parent $target) -Force | Out-Null
Copy-Item -LiteralPath $source -Destination $target -Recurse
Get-FileHash -LiteralPath (Join-Path $target 'SKILL.md') -Algorithm SHA256