用途:当用户明确要求创建或更新 XIP 时,在 GitHub 上创建和编辑 XIP issue,并把本地备份同步到 docs/proposals/xip/。读取、审计或实现 XIP 不授权修改 issue、修复标签或恢复上传;未被要求时应只报告差异。
核心原则:GitHub 优先,issue body 即完整 XIP markdown,状态(open/closed/parked)只存在于 GitHub 的 issue 状态与标签中;docs/proposals/xip/ 为单一文件夹备份,所有文件均放于此,状态不体现在路径中,避免移动文件导致链接失效。本地文件夹对 XIP 内容只读,不可在本地编辑,应改 issue 后再同步。
主要工作流: 审计:按规范 ID(XIP####)比较本地文件名与全部 GitHub issues 标题,不只看 xip 标签,避免漏掉标签缺失的 issue。参考命令:gh issue list --repo ShareX/XerahS --state all --limit 500 --json number,title,url,state,labels。 标签修复:若 issue 标题含 XIP#### 但无 xip 标签,应加标签而非新建重复 issue,因为 sync-from-github.ps1 只读取带 xip 标签的 issue。示例:gh issue edit <number> --repo ShareX/XerahS --add-label "xip"。 创建缺失 issue:对本地独有 XIP,用对应文件作为 body 创建 issue 并加 xip 标签;标题规范为 XIP#### 简短描述标题。示例:gh issue create --title "XIP0044 Your Title" --label "xip" --body-file path/to/draft.md。创建后重新核对数量与标签,并检查 git status --short。 新建 XIP:选择下一编号时应列出全部 issue(不只按标签),标题格式为 XIP0044 Short Descriptive Title;body 为完整 XIP markdown,不加包装;标签为 xip,若停用则加 parked。 编辑 XIP:在 GitHub 编辑标题或 body,再运行同步脚本;示例:gh issue edit <number> --title "XIP0044 New Title" --body-file path/to/updated.md。 同步备份:在仓库根目录运行 ./.ai/skills/sync-xips/scripts/sync-from-github.ps1,读取所有带 xip 标签的 issue,为每个 XIP 写入或覆盖 docs/proposals/xip/ 下的 .md 文件;文件名为 XIP####-title-slug.md,内容为 issue body。运行后会重命名和改写旧文件,可能造成大范围本地变更,需谨慎。 恢复:若 XIP 唯一副本在本地,可用该文件作为 body 新建 issue 并加 xip 标签:gh issue create --title "XIP0044 Title From File" --label "xip" --body-file "docs/proposals/xip/XIP0044-Something.md",随后运行同步。
命名规范:issue 标题与首个标题为 XIP0044 Short Descriptive Title,四位补零、编号后单空格、无中括号、冒号或短横线;文件名为 XIP0044-short-descriptive-title.md。
脚本位置:同步脚本 .ai/skills/sync-xips/scripts/sync-from-github.ps1;旧文件一次性合并脚本 .ai/skills/sync-xips/scripts/merge-old-xips.ps1。需从仓库根目录运行,依赖 gh CLI 与 PowerShell。
限制:XIP 结构、模板与写作模式另见 XIP writing reference,本技能只负责操作流程;不触发读取或实现 XIP;资料未说明具体收费、平台支持范围或效果指标。