用途：在 SpecWeave 规格（spec）与 GitHub Projects 之间做双向同步，让团队在 GitHub 中查看进度。默认行为为双向同步（push 与 pull）。注意：本技能只提供帮助与指引，实际同步应直接使用 /sw-github:sync-spec 命令，命令执行时本技能不应自动激活。
主要能力：将 spec 导出为 GitHub Project（含标题、描述、Backlog/In Progress/Done 列），并为每个用户故事创建 Issue（验收标准为复选框、带标签）；任务完成后更新 Issue 复选框、标签与项目卡片列及进度；spec 全部完成时关闭 Issue 并归档项目；支持用 /sw-github:import-project <project-number> 将已有 GitHub Project 导入为 spec。同步对象是 spec（永久文档），不是 increments。
使用方式：需安装并认证 GitHub CLI（gh）。安装示例：brew install gh（macOS）、sudo apt install gh（Ubuntu）、choco install gh（Windows）；认证：gh auth login；验证：gh auth status。常用命令：/sw-github:sync-spec spec-001、/sw-github:sync-spec --all、/sw-github:import-project 123、/sw-github:status spec-001。配置写在 .specweave/config.json 的 plugins.settings.specweave-github 下，可设 repo、autoSyncSpecs、syncDirection、defaultLabels、syncFrequency 等。
适用场景：开发者本地维护 spec，自动同步保持团队可见；项目经理在 GitHub Projects UI 跟踪进度；干系人用熟悉的 GitHub 界面查看状态。
限制：spec 是唯一事实来源，GitHub 仅为镜像；冲突时可用 /sw-github:sync-spec spec-001 --force 覆盖项目。仅同步标题、概述、进度、用户故事与验收标准，不同步代码差异与文件内容。使用环境中的 GITHUB_TOKEN 或 GH_TOKEN，遵循仓库读写权限。故障排查可检查 gh auth status、仓库写权限、配置、网络、项目是否存在及 gh api rate_limit。其余细节暂未提供。