@mison/ling 1.2.3 → 1.2.4

package/CHANGELOG.md

@@ -7,6 +7,16 @@
 
 ## [Unreleased]
 
+## [ling-1.2.4] - 2026-03-15
+
+### 修复
+
+- 修复 `ling spec enable` 在全局 `codex` Skills 已存在时重新写回 Gemini CLI 重复 Skill 的问题，并避免将仅同名但内容不同的 Gemini 专用 Skill 误判为重复副本。
+
+### 维护
+
+- 完善仓库根 `.gitignore`，补充测试临时目录、日志缓存和 Web 构建产物忽略规则。
+
 ## [ling-1.2.3] - 2026-03-15
 
 ### 修复

package/README.md

@@ -47,7 +47,7 @@ ling global sync --target antigravity
 | 你要做什么 | 命令 | 结果 |
 | --- | --- | --- |
 | 给当前项目安装完整资产 | `ling init` | 项目内生成 `.agent/` / `.agents/`；共享 `.agent/` 时会维护 `.ling/install-state.json` |
-| 给电脑全局同步可复用 Skills | `ling global sync` | 写入 `~/.agents/skills/`、`~/.gemini/antigravity/skills/` 等，并自动清理 Gemini CLI 的重复副本 |
+| 给电脑全局同步可复用 Skills | `ling global sync` | 写入 `~/.agents/skills/`、`~/.gemini/skills/`、`~/.gemini/antigravity/skills/`；若与 universal 根目录重复，会自动清理 Gemini CLI 副本 |
 | 给项目启用 Spec 工作流 | `ling spec init` | 项目内生成 `issues.csv` 等 Spec 资产 |
 
 一句话区分：
@@ -128,6 +128,8 @@ ling spec init --csv-only
 - `--csv-only`：`<project>/issues.csv`、`<project>/docs/reviews/`、`<project>/docs/handoff/`
 - 全局 Spec 资源：`~/.ling/spec/templates/`、`~/.ling/spec/references/`、`~/.ling/spec/profiles/`
 
+如果这台电脑已经有 `~/.agents/skills/`，`ling spec enable` 在启用 `gemini` 目标时也会自动清理 `~/.gemini/skills/` 里的同名重复副本；若同名 Skill 内容不同，则会保留 Gemini 专用版本，不会误删。
+
 如果你只想要一个本机演练空间，而不是某个真实项目：
 
 ```bash

package/bin/ling-cli.js

@@ -1364,11 +1364,12 @@ function reconcileGeminiGlobalSkillsAgainstUniversalRoot(timestamp, options) {
     const geminiRoot = geminiDestination.skillsRoot;
 
     if (!fs.existsSync(universalRoot) || !fs.existsSync(geminiRoot)) {
-        return { removed: 0, backedUp: 0 };
+        return { removed: 0, backedUp: 0, skippedConflicts: 0 };
     }
 
     let removed = 0;
     let backedUp = 0;
+    let skippedConflicts = 0;
     for (const skillName of listSkillDirectories(geminiRoot)) {
         const geminiSkillDir = path.join(geminiRoot, skillName);
         const universalSkillDir = path.join(universalRoot, skillName);
@@ -1376,6 +1377,12 @@ function reconcileGeminiGlobalSkillsAgainstUniversalRoot(timestamp, options) {
             continue;
         }
 
+        if (!areDirectoriesEqual(geminiSkillDir, universalSkillDir)) {
+            log(options, `[warn] Gemini CLI Skill 与 universal 根目录同名但内容不同，已保留: ${geminiSkillDir}`);
+            skippedConflicts += 1;
+            continue;
+        }
+
         if (options.dryRun) {
             log(options, `[dry-run] 将移除 Gemini CLI 重复 Skill（由 universal 根目录提供）: ${geminiSkillDir}`);
             removed += 1;
@@ -1400,7 +1407,7 @@ function reconcileGeminiGlobalSkillsAgainstUniversalRoot(timestamp, options) {
         log(options, `[clean] 已删除空的 Gemini CLI skills 根目录: ${geminiRoot}`);
     }
 
-    return { removed, backedUp };
+    return { removed, backedUp, skippedConflicts };
 }
 
 function syncSkillDirectory(destination, srcDir, destDir, timestamp, options) {
@@ -2752,6 +2759,9 @@ async function commandSpecEnable(options) {
     if (targets.includes("codex")) {
         migrateLegacyCodexGlobalSkills(timestamp, options);
     }
+    if (targets.includes("codex") || targets.includes("gemini")) {
+        reconcileGeminiGlobalSkillsAgainstUniversalRoot(timestamp, options);
+    }
 
     log(options, `[ok] Spec Profile 已启用 (Targets: ${targets.join(", ")})`);
 }

package/docs/PLAN.md

@@ -41,6 +41,7 @@
     - References：`$HOME/.ling/spec/references/`
     - Profiles：`$HOME/.ling/spec/profiles/`
   - 回退原则：启用前先备份同名资源；停用时优先恢复原资源
+  - 与全局 Skills 的关系：若机器上已存在 `$HOME/.agents/skills/`，启用包含 `gemini` 的 Spec 目标时会自动清理 `$HOME/.gemini/skills/` 中与 universal 根目录完全相同的重复副本；同名但内容不同的 Gemini 专用 Skill 会保留
 - 项目层（工作区级）命令：`ling spec init` / `ling spec doctor`
   - 默认作用于当前目录；`--spec-workspace` 才会使用 `$HOME/.ling/spec-workspace`
   - 完整模式：写入 `.ling/spec/`、`issues.csv`、`docs/reviews/`、`docs/handoff/`

package/docs/TECH.md

@@ -65,7 +65,7 @@ cd web && npm install && npm run lint
 - 覆盖前备份：覆盖同名 Skill 前备份到 `$HOME/.ling/backups/global/<timestamp>/<consumer>/<skill>/...`
   - `consumer` 可能是 `codex`、`gemini-cli`、`antigravity`
 - 遗留迁移：若检测到旧版 `~/.codex/skills/`，同步 codex 时会迁移到 `~/.agents/skills/` 并清理，避免 Skills 重复（冲突内容会备份到 `.../codex-legacy/<skill>/...`）
-- Gemini 去重：若 `~/.agents/skills/` 已存在，同步 gemini 后会移除 `~/.gemini/skills/` 内同名重复目录，并备份到 `.../gemini-cli-redundant/<skill>/...`
+- Gemini 去重：若 `~/.agents/skills/` 已存在，同步 gemini 后会移除 `~/.gemini/skills/` 内内容完全相同的同名重复目录，并备份到 `.../gemini-cli-redundant/<skill>/...`；若只是同名但内容不同，则记录警告并保留 Gemini 专用版本
 
 ### 测试隔离
 - `LING_GLOBAL_ROOT`：替代 `$HOME`（用于测试与 CI，避免污染真实用户目录）
@@ -89,6 +89,7 @@ cd web && npm install && npm run lint
     - 会校验 `issues.csv` 表头与状态枚举
     - 当项目缺少 `.ling/spec/` 但已启用全局 Spec 时，会使用全局 Spec 资产作为后备
 - Spec 源目录：`.spec/`
+- 若 `spec enable` 包含 `gemini` 或 `codex`，启用后还会执行一次 Gemini CLI 重复 Skill 清理，避免全局 universal Skill 与 Gemini CLI 同时暴露同名副本
 
 ### 心智模型
 - `ling spec enable`：给这台电脑安装 Spec 工具箱
@@ -172,8 +173,8 @@ Windows PowerShell 示例：
 ```powershell
 $ts = "2026-03-12T12-00-00-000Z"
 $skill = "clean-code"
-Remove-Item "$HOME\\.codex\\skills\\$skill" -Recurse -Force -ErrorAction SilentlyContinue
-Copy-Item "$HOME\\.ling\\backups\\global\\$ts\\codex\\$skill" "$HOME\\.codex\\skills\\$skill" -Recurse -Force
+Remove-Item "$HOME\\.agents\\skills\\$skill" -Recurse -Force -ErrorAction SilentlyContinue
+Copy-Item "$HOME\\.ling\\backups\\global\\$ts\\codex\\$skill" "$HOME\\.agents\\skills\\$skill" -Recurse -Force
 ```
 
 Gemini CLI 回滚示例：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mison/ling",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "面向 Gemini CLI、Antigravity 与 Codex 的中文 AI Agent 模板工具包",
   "repository": {
     "type": "git",

package/tests/spec-profile.test.js

@@ -142,6 +142,47 @@ describe("Spec Profile", () => {
         assert.ok(!fs.existsSync(antigravitySkill), "gemini spec enable should not install antigravity skill");
     });
 
+    test("spec enable should prune redundant gemini skills when codex universal skills already exist", () => {
+        const env = { LING_GLOBAL_ROOT: tempRoot };
+
+        const globalResult = runCli(["global", "sync", "--target", "codex", "--quiet"], { env });
+        assert.strictEqual(globalResult.status, 0, globalResult.stderr || globalResult.stdout);
+
+        const enableResult = runCli(["spec", "enable", "--quiet"], { env });
+        assert.strictEqual(enableResult.status, 0, enableResult.stderr || enableResult.stdout);
+
+        const geminiSkillRoot = path.join(tempRoot, ".gemini", "skills");
+        const antigravitySkill = path.join(tempRoot, ".gemini", "antigravity", "skills", "harness-engineering", "SKILL.md");
+        const codexSkill = path.join(tempRoot, ".agents", "skills", "harness-engineering", "SKILL.md");
+        assert.ok(!fs.existsSync(geminiSkillRoot), "redundant gemini spec skills should be pruned after enable");
+        assert.ok(fs.existsSync(antigravitySkill), "antigravity spec skill should still be installed");
+        assert.ok(fs.existsSync(codexSkill), "codex spec skill should still be installed");
+
+        const backupRoot = path.join(tempRoot, ".ling", "backups", "global");
+        const timestamps = fs
+            .readdirSync(backupRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+        assert.ok(timestamps.length > 0, "backup timestamp directory missing");
+
+        const redundantBackup = path.join(backupRoot, timestamps[timestamps.length - 1], "gemini-cli-redundant", "harness-engineering", "SKILL.md");
+        assert.ok(fs.existsSync(redundantBackup), "backup for redundant gemini spec skill missing");
+    });
+
+    test("spec enable should keep gemini-only skill when content differs from codex universal root", () => {
+        const env = { LING_GLOBAL_ROOT: tempRoot };
+        const codexSkillDir = path.join(tempRoot, ".agents", "skills", "harness-engineering");
+        fs.mkdirSync(codexSkillDir, { recursive: true });
+        fs.writeFileSync(path.join(codexSkillDir, "SKILL.md"), "codex-only variant", "utf8");
+
+        const enableResult = runCli(["spec", "enable", "--target", "gemini", "--quiet"], { env });
+        assert.strictEqual(enableResult.status, 0, enableResult.stderr || enableResult.stdout);
+
+        const geminiSkill = path.join(tempRoot, ".gemini", "skills", "harness-engineering", "SKILL.md");
+        assert.ok(fs.existsSync(geminiSkill), "gemini-only skill should be kept when content differs");
+        assert.strictEqual(fs.readFileSync(geminiSkill, "utf8"), fs.readFileSync(path.join(REPO_ROOT, ".spec", "skills", "harness-engineering", "SKILL.md"), "utf8"));
+    });
+
     test("spec enable should migrate legacy codex global skill path to ~/.agents/skills", () => {
         const env = { LING_GLOBAL_ROOT: tempRoot };
         const stateDir = path.join(tempRoot, ".ling", "spec");