mancode 0.2.0 → 0.2.1

package/README.md

@@ -82,9 +82,9 @@ testing, and multi-agent review: playoffs, every possession counts.
 .claude/                         # Claude Code: hooks, skills, agents
 .cursor/rules/                   # Cursor: project rules
 AGENTS.md                        # Codex CLI: managed instruction block
-.codex/skills/                   # Codex CLI: mode skills
+.agents/skills/                   # Codex CLI: mode skills
 .github/copilot-instructions.md  # GitHub Copilot: managed instruction block
-.zcode/skills/                   # ZCode: project mode skills
+.agents/skills/                   # ZCode: project mode skills
 ```
 
 `.mancode/` stores local state, project style signals, workflow reports, and
@@ -252,7 +252,7 @@ Supported platforms:
 - Codex CLI: managed `AGENTS.md` block
 - GitHub Copilot: managed `.github/copilot-instructions.md` block
 - ZCode: managed `AGENTS.md` block and provisional `$man*` skills in
-  `.zcode/skills/`; project skill discovery and slash commands pending verified
+  `.agents/skills/`; project skill discovery and slash commands pending verified
   workspace paths
 - Windsurf, Cline, Roo Code: planned later
 
@@ -320,9 +320,9 @@ Installed platforms:
 Platform status:
   ✓ Claude Code: ready (.claude/)
   ✓ Cursor: ready (.cursor/rules/)
-  ✓ Codex CLI: ready (AGENTS.md + .codex/skills/)
+  ✓ Codex CLI: ready (AGENTS.md + .agents/skills/)
   ✓ GitHub Copilot: ready (.github/copilot-instructions.md)
-  ✓ ZCode: ready (AGENTS.md + .zcode/skills/)
+  ✓ ZCode: ready (AGENTS.md + .agents/skills/)
 
 Hooks:
   ✓ session-start.sh
@@ -480,7 +480,7 @@ markers is preserved.
 
 ### ZCode skills not appearing
 
-Ensure `.zcode/skills/man8/SKILL.md` through `.zcode/skills/mansolo/SKILL.md`
+Ensure `.agents/skills/man8/SKILL.md` through `.agents/skills/mansolo/SKILL.md`
 exist, then restart or refresh ZCode. ZCode slash commands are not generated
 yet because the workspace command file path still needs explicit verification.
 

package/README.zh-CN.md

@@ -76,9 +76,9 @@ mancode init
 .claude/                         # Claude Code：hooks、skills、agents
 .cursor/rules/                   # Cursor：项目 rules
 AGENTS.md                        # Codex CLI：托管 instruction block
-.codex/skills/                   # Codex CLI：mode skills
+.agents/skills/                   # Codex CLI：mode skills
 .github/copilot-instructions.md  # GitHub Copilot：托管 instruction block
-.zcode/skills/                   # ZCode：项目 mode skills
+.agents/skills/                   # ZCode：项目 mode skills
 ```
 
 `.mancode/` 保存本地状态、项目风格信号、工作流报告和团队记忆。平台文件保存对应
@@ -227,7 +227,7 @@ mancode init --platform cursor
 - Cursor：`.cursor/rules/*.mdc` rules
 - Codex CLI：托管 `AGENTS.md` block
 - GitHub Copilot：托管 `.github/copilot-instructions.md` block
-- ZCode：托管 `AGENTS.md` block，并暂按 `.zcode/skills/` 生成 `$man*`
+- ZCode：托管 `AGENTS.md` block，并暂按 `.agents/skills/` 生成 `$man*`
   skills；项目级 skill 发现和 slash commands 仍需确认 workspace 路径后再发布承诺
 - Windsurf、Cline、Roo Code：后续计划
 
@@ -295,9 +295,9 @@ Installed platforms:
 Platform status:
   ✓ Claude Code: ready (.claude/)
   ✓ Cursor: ready (.cursor/rules/)
-  ✓ Codex CLI: ready (AGENTS.md + .codex/skills/)
+  ✓ Codex CLI: ready (AGENTS.md + .agents/skills/)
   ✓ GitHub Copilot: ready (.github/copilot-instructions.md)
-  ✓ ZCode: ready (AGENTS.md + .zcode/skills/)
+  ✓ ZCode: ready (AGENTS.md + .agents/skills/)
 
 Hooks:
   ✓ session-start.sh
@@ -449,7 +449,7 @@ mancode 要求目标目录有 `.git` 或 `package.json`。请在 git 仓库或 N
 
 ### ZCode skills 未出现
 
-确认 `.zcode/skills/man8/SKILL.md` 到 `.zcode/skills/mansolo/SKILL.md`
+确认 `.agents/skills/man8/SKILL.md` 到 `.agents/skills/mansolo/SKILL.md`
 都存在，然后重启或刷新 ZCode。当前尚不生成 ZCode `/man*` slash commands，
 因为 workspace command 的文件路径仍需显式验证。
 

package/dist/cli.js

@@ -1785,6 +1785,10 @@ var MODE_NAMES = [
 ];
 var CODEX_SKILL_MANAGED_MARKER = "<!-- Managed by mancode:codex-skill. Do not edit this file manually. -->";
 var ZCODE_SKILL_MANAGED_MARKER = "<!-- Managed by mancode:zcode-skill. Do not edit this file manually. -->";
+var MANCODE_AGENT_SKILL_MARKERS = [
+  CODEX_SKILL_MANAGED_MARKER,
+  ZCODE_SKILL_MANAGED_MARKER
+];
 function renderModeSkill(mode, commandPrefix = "$") {
   const meta = MODE_META[mode];
   const stateMode = mode === "mansolo" ? "solo" : mode;
@@ -1826,7 +1830,7 @@ async function installCodexSkills(projectRoot, minimal) {
     await removeCodexSkills(projectRoot);
     return;
   }
-  const skillsDir = path4.join(projectRoot, ".codex", "skills");
+  const skillsDir = path4.join(projectRoot, ".agents", "skills");
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     await mkdir4(modeDir, { recursive: true });
@@ -1846,7 +1850,8 @@ async function installCodexSkills(projectRoot, minimal) {
       path4.join(modeDir, "SKILL.md"),
       content,
       CODEX_SKILL_MANAGED_MARKER,
-      "Codex"
+      "Codex",
+      MANCODE_AGENT_SKILL_MARKERS
     );
   }
 }
@@ -1855,7 +1860,7 @@ async function installZcodeSkills(projectRoot, minimal) {
     await removeZcodeSkills(projectRoot);
     return;
   }
-  const skillsDir = path4.join(projectRoot, ".zcode", "skills");
+  const skillsDir = path4.join(projectRoot, ".agents", "skills");
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     await mkdir4(modeDir, { recursive: true });
@@ -1875,7 +1880,8 @@ async function installZcodeSkills(projectRoot, minimal) {
       path4.join(modeDir, "SKILL.md"),
       content,
       ZCODE_SKILL_MANAGED_MARKER,
-      "ZCode"
+      "ZCode",
+      MANCODE_AGENT_SKILL_MARKERS
     );
   }
 }
@@ -1925,7 +1931,10 @@ async function installCopilotPrompts(projectRoot, minimal) {
   }
 }
 async function removeCodexSkills(projectRoot) {
-  const skillsDir = path4.join(projectRoot, ".codex", "skills");
+  await cleanCodexManagedSkills(path4.join(projectRoot, ".agents", "skills"));
+  await cleanCodexManagedSkills(path4.join(projectRoot, ".codex", "skills"));
+}
+async function cleanCodexManagedSkills(skillsDir) {
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     const skillPath = path4.join(modeDir, "SKILL.md");
@@ -1937,7 +1946,10 @@ async function removeCodexSkills(projectRoot) {
   await removeIfEmpty(skillsDir);
 }
 async function removeZcodeSkills(projectRoot) {
-  const skillsDir = path4.join(projectRoot, ".zcode", "skills");
+  await cleanZcodeManagedSkills(path4.join(projectRoot, ".agents", "skills"));
+  await cleanZcodeManagedSkills(path4.join(projectRoot, ".zcode", "skills"));
+}
+async function cleanZcodeManagedSkills(skillsDir) {
   for (const mode of MODE_NAMES) {
     const modeDir = path4.join(skillsDir, mode);
     const skillPath = path4.join(modeDir, "SKILL.md");
@@ -1972,9 +1984,9 @@ async function removeIfEmpty(dir) {
   } catch {
   }
 }
-async function writeManagedSkill(skillPath, content, marker, platformLabel) {
+async function writeManagedSkill(skillPath, content, marker, platformLabel, recognizedMarkers = [marker]) {
   const existing = await readTextIfExists2(skillPath);
-  if (existing !== null && !existing.includes(marker)) {
+  if (existing !== null && !recognizedMarkers.some((m) => existing.includes(m))) {
     throw new Error(
       `refusing to overwrite user-authored ${platformLabel} skill: ${skillPath}`
     );
@@ -3371,12 +3383,12 @@ function printPlatformCreatedFiles(platform) {
   }
   if (platform === "codex") {
     console.log("  AGENTS.md                   # Codex managed block");
-    console.log("  .codex/skills/              # Codex mode skills");
+    console.log("  .agents/skills/              # Codex mode skills");
     return;
   }
   if (platform === "zcode") {
     console.log("  AGENTS.md                   # ZCode managed block");
-    console.log("  .zcode/skills/              # ZCode mode skills");
+    console.log("  .agents/skills/             # ZCode mode skills");
     return;
   }
   console.log("  .github/copilot-instructions.md # Copilot instructions");
@@ -3452,15 +3464,15 @@ async function checkPlatformReadiness(rootDir, platform) {
         readyDetail: "managed block present"
       };
     }
-    const skillsDir = path14.join(rootDir, ".codex", "skills");
+    const skillsDir = path14.join(rootDir, ".agents", "skills");
     const hasSkills = await allManagedSkills(
       MODE_NAMES.map((mode) => path14.join(skillsDir, mode, "SKILL.md")),
-      CODEX_SKILL_MANAGED_MARKER
+      MANCODE_AGENT_SKILL_MARKERS
     );
     return {
       present: true,
       ready: hasSkills,
-      target: "AGENTS.md + .codex/skills/",
+      target: "AGENTS.md + .agents/skills/",
       readyDetail: hasSkills ? "managed block and skills present" : "mode skills are missing, incomplete, or user-authored"
     };
   }
@@ -3486,15 +3498,15 @@ async function checkPlatformReadiness(rootDir, platform) {
         readyDetail: "managed block present"
       };
     }
-    const skillsDir = path14.join(rootDir, ".zcode", "skills");
+    const skillsDir = path14.join(rootDir, ".agents", "skills");
     const hasSkills = await allManagedSkills(
       MODE_NAMES.map((mode) => path14.join(skillsDir, mode, "SKILL.md")),
-      ZCODE_SKILL_MANAGED_MARKER
+      MANCODE_AGENT_SKILL_MARKERS
     );
     return {
       present: true,
       ready: hasSkills,
-      target: "AGENTS.md + .zcode/skills/",
+      target: "AGENTS.md + .agents/skills/",
       readyDetail: hasSkills ? "managed block and skills present" : "mode skills are missing, incomplete, or user-authored"
     };
   }
@@ -3537,16 +3549,16 @@ async function allPathsExist(paths) {
   const results = await Promise.all(paths.map(pathExists5));
   return results.every(Boolean);
 }
-async function allManagedSkills(paths, marker) {
+async function allManagedSkills(paths, markers) {
   const results = await Promise.all(
-    paths.map((filePath) => fileHasText(filePath, marker))
+    paths.map((filePath) => fileHasAnyMarker(filePath, markers))
   );
   return results.every(Boolean);
 }
-async function fileHasText(filePath, needle) {
+async function fileHasAnyMarker(filePath, needles) {
   try {
     const content = await fs3.readFile(filePath, "utf-8");
-    return content.includes(needle);
+    return needles.some((needle) => content.includes(needle));
   } catch {
     return false;
   }
@@ -5602,7 +5614,9 @@ async function uninstallCodex(rootDir) {
     }
   } catch {
   }
-  await removeCodexSkills(rootDir);
+  if (!await otherAgentSkillsPlatformActive(rootDir, "codex")) {
+    await removeCodexSkills(rootDir);
+  }
 }
 async function uninstallCopilot(rootDir) {
   const instructionsPath = path22.join(
@@ -5640,7 +5654,9 @@ async function uninstallZcode(rootDir) {
     }
   } catch {
   }
-  await removeZcodeSkills(rootDir);
+  if (!await otherAgentSkillsPlatformActive(rootDir, "zcode")) {
+    await removeZcodeSkills(rootDir);
+  }
 }
 async function removeFromConfig(rootDir, platform) {
   const configPath = path22.join(rootDir, ".mancode", "config.json");
@@ -5678,6 +5694,20 @@ async function pathExists11(p) {
     return false;
   }
 }
+async function otherAgentSkillsPlatformActive(rootDir, excluding) {
+  try {
+    const raw = await readFile8(
+      path22.join(rootDir, ".mancode", "config.json"),
+      "utf-8"
+    );
+    const config = JSON.parse(raw);
+    const platforms = Array.isArray(config.platforms) ? config.platforms : [];
+    const peers = ["codex", "zcode"].filter((p) => p !== excluding);
+    return platforms.some((p) => peers.includes(p));
+  } catch {
+    return false;
+  }
+}
 
 // src/commands/version.ts
 import process9 from "process";