@ranger1/dx 0.1.102 → 0.1.104

package/README.md

@@ -221,8 +221,9 @@ dx test e2e quantify apps/quantify/e2e/health/health.e2e-spec.ts
 
 关于 `dx initial`：
 
-- `dx initial` 会把 npm 包内置的 `skills/` 同步到 `~/.codex/skills` 与 `~/.claude/skills`。
-- 包内管理的同名 skill 目录会按当前包内容替换；旧版本中已删除的官方 skill 会被清理。
+- `dx initial` 会把 npm 包内置的 `skills/` 覆盖同步到 `~/.agents/skills`。
+- `~/.claude/skills` 中包内管理的同名非软链接 skill 会先删除，再创建指向 `~/.agents/skills` 的软链接。
+- `~/.codex/skills` 中包内管理的同名非软链接 skill 会被清理；已有软链接不会按旧副本删除。
 - 不属于包内管理的其他用户自有 skill 目录会保留。
 
 关于 `help`：

package/lib/codex-initial.js

@@ -4,9 +4,13 @@ import os from 'node:os'
 
 import { logger } from './logger.js'
 
-const DEPRECATED_SKILL_DIRS = ['pr-review-loop', 'git-commit-and-pr', 'autospec']
 const TEMP_DIR_PATTERN = /^\..+\.(tmp|backup)-\d+-\d+$/
 
+async function collectSkillNames(dir) {
+  const entries = await fs.readdir(dir, { withFileTypes: true })
+  return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name)
+}
+
 async function collectAllFiles(dir) {
   const out = []
 
@@ -65,7 +69,6 @@ async function copyDirMerge({ srcDir, dstDir }) {
 
   for (const entry of entries) {
     if (!entry.isDirectory()) continue
-    if (DEPRECATED_SKILL_DIRS.includes(entry.name)) continue
 
     const srcSkillDir = join(srcDir, entry.name)
     const dstSkillDir = join(dstDir, entry.name)
@@ -109,9 +112,18 @@ async function copyDirMerge({ srcDir, dstDir }) {
   return { fileCount }
 }
 
-async function removeDeprecatedSkillDirs(skillsDir) {
-  for (const dirName of DEPRECATED_SKILL_DIRS) {
-    await fs.rm(join(skillsDir, dirName), { recursive: true, force: true })
+async function removeManagedNonSymlinkSkills(skillsDir, skillNames) {
+  for (const skillName of skillNames) {
+    const target = join(skillsDir, skillName)
+    let stat
+    try {
+      stat = await fs.lstat(target)
+    } catch (error) {
+      if (error?.code === 'ENOENT') continue
+      throw error
+    }
+    if (stat.isSymbolicLink()) continue
+    await fs.rm(target, { recursive: true, force: true })
   }
 }
 
@@ -124,32 +136,57 @@ async function removeStaleTempDirs(skillsDir) {
   }
 }
 
+async function linkSkillsToClaude({ skillNames, agentsSkillsDir, claudeSkillsDir }) {
+  for (const skillName of skillNames) {
+    const srcSkillDir = join(agentsSkillsDir, skillName)
+    const claudeSkillPath = join(claudeSkillsDir, skillName)
+
+    let stat
+    try {
+      stat = await fs.lstat(claudeSkillPath)
+    } catch (error) {
+      if (error?.code !== 'ENOENT') throw error
+    }
+
+    if (stat?.isSymbolicLink()) {
+      const currentTarget = await fs.readlink(claudeSkillPath)
+      if (currentTarget === srcSkillDir) continue
+      await fs.rm(claudeSkillPath, { recursive: true, force: true })
+    } else if (stat) {
+      await fs.rm(claudeSkillPath, { recursive: true, force: true })
+    }
+
+    await fs.symlink(srcSkillDir, claudeSkillPath, 'dir')
+  }
+}
+
 export async function runCodexInitial(options = {}) {
   const packageRoot = options.packageRoot
   if (!packageRoot) throw new Error('runCodexInitial: 缺少 packageRoot')
 
   const homeDir = options.homeDir || os.homedir()
   const srcSkillsDir = join(packageRoot, 'skills')
-  const targets = [
-    { name: 'codex', dir: join(homeDir, '.codex', 'skills') },
-    { name: 'claude', dir: join(homeDir, '.claude', 'skills') },
-  ]
+  const agentsSkillsDir = join(homeDir, '.agents', 'skills')
+  const claudeSkillsDir = join(homeDir, '.claude', 'skills')
+  const codexSkillsDir = join(homeDir, '.codex', 'skills')
 
   await assertDirExists(srcSkillsDir, '模板目录 skills')
+  const skillNames = await collectSkillNames(srcSkillsDir)
 
-  const stats = []
-  for (const target of targets) {
-    await ensureDir(target.dir)
-    await removeStaleTempDirs(target.dir)
-    await removeDeprecatedSkillDirs(target.dir)
-    const copyStats = await copyDirMerge({ srcDir: srcSkillsDir, dstDir: target.dir })
-    await removeStaleTempDirs(target.dir)
-    await removeDeprecatedSkillDirs(target.dir)
-    stats.push({ ...target, ...copyStats })
-  }
+  await ensureDir(codexSkillsDir)
+  await ensureDir(claudeSkillsDir)
+  await ensureDir(agentsSkillsDir)
+
+  await removeManagedNonSymlinkSkills(codexSkillsDir, skillNames)
+  await removeManagedNonSymlinkSkills(claudeSkillsDir, skillNames)
+
+  await removeStaleTempDirs(agentsSkillsDir)
+  const copyStats = await copyDirMerge({ srcDir: srcSkillsDir, dstDir: agentsSkillsDir })
+  await removeStaleTempDirs(agentsSkillsDir)
+  await linkSkillsToClaude({ skillNames, agentsSkillsDir, claudeSkillsDir })
 
   logger.success('已初始化 skills 模板')
-  for (const target of stats) {
-    logger.info(`${target.name} skills: 覆盖复制 ${target.fileCount} 个文件 -> ${target.dir}`)
-  }
+  logger.info(`agents skills: 覆盖复制 ${copyStats.fileCount} 个文件 -> ${agentsSkillsDir}`)
+  logger.info(`claude skills: 已创建 ${skillNames.length} 个软链接 -> ${claudeSkillsDir}`)
+  logger.info(`codex skills: 已清理 ${skillNames.length} 个包内托管 skill 的旧副本 -> ${codexSkillsDir}`)
 }

package/lib/exec.js

@@ -9,6 +9,7 @@ import {
   resolveTargetRequiredVars,
 } from './env-policy.js'
 import { confirmManager } from './confirm.js'
+import { ensureNxIgnoreToolDirs, isNxCommand } from './nx-ignore.js'
 
 const execPromise = promisify(nodeExec)
 
@@ -171,6 +172,17 @@ export class ExecManager {
       }
     }
 
+    if (isNxCommand(fullCommand)) {
+      try {
+        const result = ensureNxIgnoreToolDirs(cwd || process.cwd())
+        if (result.changed) {
+          logger.info(`已更新 .nxignore，排除工具元数据目录: ${result.added.join(', ')}`)
+        }
+      } catch (error) {
+        logger.warn(`自动更新 .nxignore 失败: ${error?.message || String(error)}`)
+      }
+    }
+
     logger.command(fullCommand)
 
     // 执行命令（可能重试）

package/lib/nx-ignore.js

@@ -0,0 +1,45 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+export const NX_IGNORE_TOOL_DIR_PATTERNS = [
+  '.cache/',
+  '.claude/',
+  '.codex/',
+  '.idea/',
+  '.omc/',
+  '.omx/',
+  '.opencode/',
+  '.pytest_cache/',
+]
+
+const MANAGED_BLOCK_START = '# dx managed tool metadata ignores'
+
+export function isNxCommand(command) {
+  return /\bnx(?:\.js)?\b/.test(String(command || ''))
+}
+
+export function ensureNxIgnoreToolDirs(projectRoot = process.cwd()) {
+  const root = String(projectRoot || process.cwd())
+  const nxIgnorePath = join(root, '.nxignore')
+  const existing = existsSync(nxIgnorePath) ? readFileSync(nxIgnorePath, 'utf8') : ''
+  const existingLines = new Set(
+    existing
+      .split(/\r?\n/)
+      .map(line => line.trim())
+      .filter(Boolean),
+  )
+  const missing = NX_IGNORE_TOOL_DIR_PATTERNS.filter(pattern => !existingLines.has(pattern))
+
+  if (missing.length === 0) {
+    return { changed: false, path: nxIgnorePath, added: [] }
+  }
+
+  const prefix = existing.trimEnd()
+  const blockLines = existingLines.has(MANAGED_BLOCK_START)
+    ? missing
+    : [MANAGED_BLOCK_START, ...missing]
+  const next = `${prefix ? `${prefix}\n\n` : ''}${blockLines.join('\n')}\n`
+
+  writeFileSync(nxIgnorePath, next)
+  return { changed: true, path: nxIgnorePath, added: missing }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranger1/dx",
-  "version": "0.1.102",
+  "version": "0.1.104",
   "type": "module",
   "license": "MIT",
   "repository": {

package/skills/doctor/SKILL.md

@@ -7,7 +7,7 @@ description: 仅在用户显式调用 $doctor 或明确要求使用 doctor 技
 
 ## 概览
 
-本技能用于把当前机器调整到可稳定运行 Codex 开发工作流的状态。
+本技能用于把当前机器调整到可稳定运行 agent 开发工作流的状态。
 
 不要把执行路径写死。模型应先识别当前系统、shell、包管理器、已有工具版本与用户权限，再自行选择最合适的检测和修复方式。完成修复后必须复检，并给出可读报告。
 
@@ -20,7 +20,8 @@ description: 仅在用户显式调用 $doctor 或明确要求使用 doctor 技
 - `node`、`npm`、`pnpm` 可用，且满足当前工作流需要。
 - `dx` 可用，并已完成必要初始化。
 - `agent-browser` 可用，且 Chromium/浏览器依赖已安装到可运行状态。
-- `rg`（ripgrep）可用。
+- `rg`（rip grep）可用。
+- `rtk` 可用。
 - 常用 PATH 配置在当前 shell 中可生效；若需要持久化，说明写入了哪个 shell 配置文件。
 
 ## 执行原则
@@ -38,7 +39,6 @@ description: 仅在用户显式调用 $doctor 或明确要求使用 doctor 技
    - 操作系统与架构
    - 当前 shell 与 PATH
    - `python3`、`python`、`node`、`npm`、`pnpm`、`dx`、`agent-browser`、`rg` 的存在性与版本
-   - `CODEX_HOME` 与相关配置目录是否存在
 2. 对照目标状态判断缺口。
 3. 制定最小修复动作并执行。
 4. 每次修复后重新验证相关项。