bowei/skills-win
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

sync: WIN10-I9-64G 2026-07-20

Browse Source
This commit is contained in:
Myfro9
2026-07-20 18:28:34 +08:00
parent 1334ad4a64
commit 2b873a1f4d
2 changed files with 82 additions and 81 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tools-sync/SKILL.md
+21 -16
View File
@@ -11,9 +11,12 @@ description: 在本机统一同步并配置 Claude Code 与 Codex 的 skills、M
注册表。这个 skill 的职责是让它们保持一致，并且可以在一台新电脑上从零复原整套配置： 注册表。这个 skill 的职责是让它们保持一致，并且可以在一台新电脑上从零复原整套配置：
- **skills 的唯一真源**是 `http://git.rpchannel.com/bowei/skills-win.git`（remote 名 `origin`）。 - **skills 的唯一真源**是 `http://git.rpchannel.com/bowei/skills-win.git`（remote 名 `origin`）。
`~\.claude\skills` 是主工作副本，`~\.codex\skills` 是同一仓库的第二个检出（镜像）。 `~\.claude\skills` 是唯一的 git 检出（主副本）；`~\.codex\skills` 下的每个 skill
是指向主副本对应目录的 **junction（目录联接）**——两个工具共享同一份物理文件，
从机制上杜绝两侧漂移，git 操作只发生在主副本一处。
Codex 没有注册命令——它在会话启动时自动扫描 `~\.codex\skills` 下所有含 `SKILL.md` Codex 没有注册命令——它在会话启动时自动扫描 `~\.codex\skills` 下所有含 `SKILL.md`
的目录，所以"注册到 Codex" = "目录出现在那里且含 SKILL.md"。 的目录（junction 对它透明），所以"注册到 Codex" = "junction 存在且指向的目录含
SKILL.md"，新开的 Codex 会话才会扫到新 skill。
- **机器相关的参数不进 git**。每台电脑的软件安装路径、IP、账号等都记录在 - **机器相关的参数不进 git**。每台电脑的软件安装路径、IP、账号等都记录在
`~\skills_env.md`（用户主目录下，天然在两个仓库检出之外，不会被 git 同步）。 `~\skills_env.md`（用户主目录下，天然在两个仓库检出之外，不会被 git 同步）。
skills 里引用参数时写"见 ~\skills_env.md 的 XXX 条目"，不写死路径。 skills 里引用参数时写"见 ~\skills_env.md 的 XXX 条目"，不写死路径。
@@ -58,21 +61,23 @@ powershell -File <skill目录>\scripts\sync_repos.ps1 -RepoUrl <origin_url>
- **不该入库的文件**：commit 前扫一眼 `git status`，运行时产物（.sqlite、.pckl、 - **不该入库的文件**：commit 前扫一眼 `git status`，运行时产物（.sqlite、.pckl、
日志、缓存目录）应加进 `.gitignore` 而不是提交。看到就顺手补 `.gitignore`。 日志、缓存目录）应加进 `.gitignore` 而不是提交。看到就顺手补 `.gitignore`。
## 阶段 2 — 同步 ~\.codex\skills（镜像检出） ## 阶段 2 — 对齐 ~\.codex\skills（junction 对账）
同一个脚本会接着处理 codex 侧。逻辑和原因： 同一个脚本接着处理 codex 侧。它对主副本的每个顶层 skill 目录做三件事：
- 已是 git 仓库 → `git pull --rebase` 即可。 - codex 侧没有同名条目 → 创建 junction（`New-Item -ItemType Junction`，
- 还不是 git 仓库（首次转换）→ 脚本执行 `git init` + `remote add origin` + Windows 上不需要管理员权限，Codex 对 junction 完全透明）。
`fetch` + `git reset origin/main`，然后**停下来**列出"本地与仓库不一致"的文件。 - 已是 junction → 跳过（内容天然一致，无需任何拷贝）。
这一步停是有原因的：codex 目录里可能有比仓库新的本地修改或 codex 独有的 - 是**真实目录**（挡住了链接）→ 脚本停下来列出这些目录。停的原因：真实目录
skill。处理原则——codex 独有且有价值的 skill，先复制到 `~\.claude\skills` 里可能有 codex 独有的、还没入库的内容。处理原则——有价值的内容先复制进
走阶段 1 入库，再回来；确认没有需要保留的差异后，用 `-Force` 重跑让脚本 `~\.claude\skills` 走阶段 1 入库，确认无需保留后用 `-Force` 重跑，脚本会
`git checkout -f` 对齐到仓库版本。codex 自带的系统 skills（`.system/`、 删掉真实目录并建 junction。
vercel 系列等）已在 `.gitignore` 里，不会被动。
- 同步完成后校验注册：仓库里每个顶层 skill 目录都应在 `~\.codex\skills` 脚本还会清理"指向已删除主副本目录"的失效 junction（skill 在仓库里被删除或
出现且含 `SKILL.md`。列出两侧目录做差集，差集应为空（忽略 .gitignore 改名后残留的链接）。codex 自带的系统 skills（`.system\`）永远不动。
中的 codex 专属条目）。提醒用户：Codex 需要开新会话才会扫到新 skills。
校验注册：主副本每个 skill 目录在 codex 侧都应有同名 junction 且透出
`SKILL.md`（脚本已内置该检查）。提醒用户：Codex 要开新会话才会扫到新 skills。
## 阶段 3 — 硬编码审计与 skills_env.md 回填 ## 阶段 3 — 硬编码审计与 skills_env.md 回填
@@ -97,7 +102,7 @@ powershell -File <skill目录>\scripts\sync_repos.ps1 -RepoUrl <origin_url>
一次审计不必把所有历史 skills 全部重构完；至少保证：新增/本次改动的 skill 零硬编码， 一次审计不必把所有历史 skills 全部重构完；至少保证：新增/本次改动的 skill 零硬编码，
存量 skill 的命中清单写进最终报告，让用户决定分批改。改动之后回到阶段 1 再 存量 skill 的命中清单写进最终报告，让用户决定分批改。改动之后回到阶段 1 再
commit + push 一次，并在 codex 侧 pull，保证两边一致。 commit + push 一次（junction 模型下 codex 侧自动同步，无需额外操作）。
## 阶段 4 — langgraph 开发环境校验 ## 阶段 4 — langgraph 开发环境校验
tools-sync/scripts/sync_repos.ps1
+60 -64
View File
@@ -1,17 +1,20 @@
# tools-sync: mechanical git sync of the two skills checkouts. # tools-sync: mechanical sync of skills between Claude Code and Codex.
# Claude side (~\.claude\skills) is the primary working copy: commit -> pull --rebase -> push. # Phase 1 — git sync of the primary checkout (~\.claude\skills): commit -> pull --rebase -> push.
# Codex side (~\.codex\skills) is a mirror checkout of the same repo: bootstrap if needed, then pull. # Phase 2 — junction reconciliation: every top-level skill dir in the primary gets a
# Judgment calls (conflicts, codex-only skills worth keeping) are left to the caller. # directory junction of the same name in ~\.codex\skills, so both tools share
# one physical copy and can never drift. Codex auto-registers any dir there
# containing SKILL.md (new sessions only).
# Judgment calls (rebase conflicts, codex-local dirs worth keeping) are left to the caller.
param( param(
[Parameter(Mandatory = $true)][string]$RepoUrl, [Parameter(Mandatory = $true)][string]$RepoUrl,
[string]$ClaudeSkills = "$env:USERPROFILE\.claude\skills", [string]$ClaudeSkills = "$env:USERPROFILE\.claude\skills",
[string]$CodexSkills = "$env:USERPROFILE\.codex\skills", [string]$CodexSkills = "$env:USERPROFILE\.codex\skills",
[string]$Branch = "main", [string]$Branch = "main",
# Bootstrap of the codex checkout stops when local files differ from the repo; # A real (non-junction) dir in the codex side that shadows a primary skill blocks
# -Force lets it overwrite them (caller must have rescued codex-only edits first). # linking; -Force deletes it and links (caller must have rescued unique content first).
[switch]$Force, [switch]$Force,
# Report what would happen without committing/pushing/checking out. # Report what would happen without committing/pushing/linking.
[switch]$DryRun [switch]$DryRun
) )
@@ -32,7 +35,7 @@ function Invoke-Git {
function Fail([string]$Msg) { Write-Host "FAIL: $Msg"; exit 1 } function Fail([string]$Msg) { Write-Host "FAIL: $Msg"; exit 1 }
# ---------- Phase 1: primary checkout (~\.claude\skills) ---------- # ---------- Phase 1: primary checkout (~\.claude\skills) ----------
Write-Host "=== [1/2] primary: $ClaudeSkills ===" Write-Host "=== [1/2] primary git sync: $ClaudeSkills ==="
if (-not (Test-Path (Join-Path $ClaudeSkills ".git"))) { if (-not (Test-Path (Join-Path $ClaudeSkills ".git"))) {
Fail "$ClaudeSkills is not a git repo. Clone $RepoUrl there first (new machine: git clone $RepoUrl `"$ClaudeSkills`")." Fail "$ClaudeSkills is not a git repo. Clone $RepoUrl there first (new machine: git clone $RepoUrl `"$ClaudeSkills`")."
} }
@@ -65,68 +68,61 @@ if (-not $DryRun) {
Write-Host "primary in sync with origin/$Branch" Write-Host "primary in sync with origin/$Branch"
} }
# ---------- Phase 2: mirror checkout (~\.codex\skills) ---------- # ---------- Phase 2: junction reconciliation (~\.codex\skills) ----------
Write-Host "=== [2/2] mirror: $CodexSkills ===" Write-Host "=== [2/2] codex junctions: $CodexSkills ==="
if (-not (Test-Path $CodexSkills)) { New-Item -ItemType Directory -Force $CodexSkills | Out-Null } if (-not (Test-Path $CodexSkills)) { New-Item -ItemType Directory -Force $CodexSkills | Out-Null }
# Bootstrap is needed when there's no repo yet, or a previous bootstrap died before # Left over from the older mirror-checkout approach; junctions need no repo here.
# origin/main ever arrived (init succeeded, fetch didn't). if (Test-Path (Join-Path $CodexSkills ".git")) {
$needBootstrap = -not (Test-Path (Join-Path $CodexSkills ".git")) Write-Host "removing stale .git from codex dir (junction model needs no second checkout)"
if (-not $needBootstrap) { if (-not $DryRun) { Remove-Item -Recurse -Force (Join-Path $CodexSkills ".git") }
# Upstream config is written as the very last bootstrap step, so its absence
# means a previous bootstrap died partway — redo it (all steps are idempotent).
$r = Invoke-Git $CodexSkills @("config", "--get", "branch.$Branch.merge")
if ($r.Code -ne 0) { $needBootstrap = $true }
} }
if ($needBootstrap) { $primarySkills = Get-ChildItem $ClaudeSkills -Directory | Where-Object { $_.Name -notlike ".*" }
Write-Host "bootstrapping mirror as a checkout of $RepoUrl" $blocked = @()
if ($DryRun) { Write-Host "(dry-run) would git init + fetch + align to origin/$Branch"; exit 0 } foreach ($d in $primarySkills) {
Invoke-Git $CodexSkills @("init") | Out-Null $link = Join-Path $CodexSkills $d.Name
Invoke-Git $CodexSkills @("remote", "add", "origin", $RepoUrl) | Out-Null if (Test-Path $link) {
Invoke-Git $CodexSkills @("remote", "set-url", "origin", $RepoUrl) | Out-Null $item = Get-Item $link
$r = Invoke-Git $CodexSkills @("fetch", "origin", $Branch) if ($item.LinkType -eq "Junction") { continue }
if ($r.Code -ne 0) { # A real dir shadows the primary skill; its content may be unique.
# Flaky server on a full first fetch is common; the primary checkout already if ($Force) {
# holds every object locally, so borrow them from disk instead. if ($DryRun) { Write-Host "(dry-run) would replace real dir with junction: $($d.Name)" ; continue }
Write-Host "server fetch failed, retrying from local primary checkout..." Remove-Item -Recurse -Force $link
$r = Invoke-Git $CodexSkills @("fetch", $ClaudeSkills, "+refs/heads/${Branch}:refs/remotes/origin/$Branch") New-Item -ItemType Junction -Path $link -Target $d.FullName | Out-Null
if ($r.Code -ne 0) { Write-Host $r.Out; Fail "fetch failed during bootstrap (server and local)." } Write-Host "replaced real dir with junction: $($d.Name)"
}
# Point index at origin/main without touching files, so status shows local-vs-repo drift.
Invoke-Git $CodexSkills @("reset", "origin/$Branch") | Out-Null
Invoke-Git $CodexSkills @("branch", "-f", $Branch, "origin/$Branch") | Out-Null
Invoke-Git $CodexSkills @("checkout", $Branch) 2>$null | Out-Null
$drift = Invoke-Git $CodexSkills @("status", "--porcelain")
# Only M is real local drift worth rescuing; D just means the file hasn't been
# materialized in this checkout yet, so overwriting loses nothing.
$modified = ($drift.Out -split "`n" | Where-Object { $_ -match '^\s*M' })
if ($modified -and -not $Force) {
Write-Host "these tracked files differ locally from the repo:"
$modified | ForEach-Object { Write-Host " $_" }
Fail "codex dir has local drift. Rescue anything worth keeping into the primary checkout, then re-run with -Force."
}
$r = Invoke-Git $CodexSkills @("checkout", "-f", $Branch)
if ($r.Code -ne 0) { Write-Host $r.Out; Fail "checkout failed during bootstrap." }
Invoke-Git $CodexSkills @("branch", "--set-upstream-to=origin/$Branch", $Branch) | Out-Null
Write-Host "mirror bootstrapped at origin/$Branch (untracked codex-local files left untouched)"
} else {
if ($DryRun) {
Invoke-Git $CodexSkills @("fetch", "origin", $Branch) | Out-Null
$r = Invoke-Git $CodexSkills @("log", "--oneline", "HEAD..origin/$Branch")
Write-Host "(dry-run) mirror is behind by:"
if ($r.Out) { Write-Host $r.Out } else { Write-Host " (nothing, or not yet a checkout)" }
} else { } else {
$st2 = Invoke-Git $CodexSkills @("status", "--porcelain") $blocked += $d.Name
if ($st2.Out) {
Write-Host "WARNING: mirror has local changes (should be edited on the primary side instead):"
Write-Host $st2.Out
} }
$r = Invoke-Git $CodexSkills @("pull", "--rebase", "origin", $Branch) } else {
if ($r.Code -ne 0) { Write-Host $r.Out; Fail "pull failed on mirror." } if ($DryRun) { Write-Host "(dry-run) would link: $($d.Name)"; continue }
Write-Host $r.Out New-Item -ItemType Junction -Path $link -Target $d.FullName | Out-Null
Write-Host "mirror in sync with origin/$Branch" Write-Host "linked: $($d.Name)"
} }
} }
Write-Host "=== sync_repos done ===" # Junctions whose primary target is gone (skill deleted/renamed upstream) confuse Codex.
foreach ($item in Get-ChildItem $CodexSkills -Directory | Where-Object { $_.LinkType -eq "Junction" }) {
$target = ($item.Target | Select-Object -First 1)
if ($target -and $target.StartsWith($ClaudeSkills) -and -not (Test-Path $target)) {
if ($DryRun) { Write-Host "(dry-run) would remove stale junction: $($item.Name)"; continue }
# A junction is just a link — removing it never touches target content.
$item.Delete()
Write-Host "removed stale junction: $($item.Name)"
}
}
if ($blocked) {
Write-Host "these codex dirs are REAL directories shadowing primary skills (not linked):"
$blocked | ForEach-Object { Write-Host " $_" }
Fail "rescue any unique content into the primary checkout, then re-run with -Force."
}
# Registration sanity: every linked skill must expose a SKILL.md for Codex to register it.
$missing = $primarySkills | Where-Object { -not (Test-Path (Join-Path $CodexSkills "$($_.Name)\SKILL.md")) }
if ($missing) {
Write-Host "WARNING: no SKILL.md visible through these links (Codex will ignore them):"
$missing | ForEach-Object { Write-Host " $($_.Name)" }
}
Write-Host "=== sync_repos done (Codex picks up changes on its next new session) ==="