@culeo/specx 0.1.0 → 0.1.1

package/README.md

@@ -88,20 +88,20 @@ specx 是一套企业级研发流程 skill 系列，核心理念是**先签合
 docs/specx/
 ├── spaces/                    # 需求空间（每个需求独立目录）
 │   └── {yyyyMMdd}-{需求摘要}/
-│       ├── Raws/               # 原始需求来源（多源分类）
+│       ├── raws/               # 原始需求来源（多源分类）
 │       │   ├── P001-{需求名称}.md       # 产品需求文档
 │       │   ├── U001-{用户反馈}.md       # 用户输入/语料
 │       │   └── ...
-│       ├── T-01-{子需求名}/
+│       ├── t-01-{子需求名}/
 │       │   ├── 00-子需求.md            # 子需求原始描述（由 demystify 产出）
 │       │   ├── 01-clarify.md           # 澄清记录
 │       │   ├── 02-spec.md              # 规格说明书
 │       │   ├── 03-design.md            # 设计方案
 │       │   └── 04-tasks.md             # 任务清单
-│       └── T-02-{子需求名}/
+│       └── t-02-{子需求名}/
 │           └── ...
 ├── wiki/                      # 项目知识库（归档沉淀）
-├── rule/                      # 框架规范
+├── rules/                      # 框架规范
 └── templates/                 # 项目专属模板
 ```
 
@@ -111,7 +111,7 @@ docs/specx/
 
 - **文件名规范**：`00-子需求.md` / `01-clarify.md` / `02-spec.md` / `03-design.md` / `04-tasks.md`
 - **wiki 知识沉淀**：`docs/specx/wiki/`，由 `specx-archive` 维护
-- **框架规范**：`docs/specx/rule/`，clarify 时跳过已有规范，不重复提问
+- **框架规范**：`docs/specx/rules/`，clarify 时跳过已有规范，不重复提问
 - **项目模板**：`docs/specx/templates/`，首次 design 时生成
 
 ---

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@culeo/specx",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Install specx skills to AI coding agents (Claude Code, Codex, etc.)",
   "type": "module",
   "bin": {
-    "specx": "./specx.js"
+    "specx": "./src/specx.js"
   },
   "dependencies": {
     "commander": "^12.0.0"

package/skills/specx-archive/SKILL.md

@@ -11,7 +11,7 @@ tags: [specx, archive, wiki, knowledge]
 
 当一个子需求完成（clarify → spec → design → code 全部走完）后，用户说"归档"、"沉淀到 wiki"、"完成这个需求"时使用。
 
-**前置判断：** 子需求目录 `T-xx/` 下已有 `clarify.md`、`spec.md`、`design.md`（及可选 `code` 相关文档）。
+**前置判断：** 子需求目录 `t-xx/` 下已有 `clarify.md`、`spec.md`、`design.md`（及可选 `code` 相关文档）。
 
 **不是触发的情况：**
 - 需求还在中途（未完成 code）
@@ -21,11 +21,11 @@ tags: [specx, archive, wiki, knowledge]
 
 ## 输入
 
-- `T-xx/00-子需求.md` — 原始需求
-- `T-xx/01-clarify.md` — 澄清后的需求
-- `T-xx/02-spec.md` — 规格说明书
-- `T-xx/03-design.md` — 设计方案
-- `T-xx/04-tasks.md` — 任务清单（已完成的）
+- `t-xx/00-子需求.md` — 原始需求
+- `t-xx/01-clarify.md` — 澄清后的需求
+- `t-xx/02-spec.md` — 规格说明书
+- `t-xx/03-design.md` — 设计方案
+- `t-xx/04-tasks.md` — 任务清单（已完成的）
 
 ---
 
@@ -54,8 +54,8 @@ docs/specx/wiki/
 
 ### 命名规则
 
-- 文件名：`{T-xx}-{简短英文名}.md`，小写，连字符分隔
-- 示例：`T01-stock-card.md`、`T03-redis-cache.md`
+- 文件名：`{t-xx}-{简短英文名}.md`，小写，连字符分隔
+- 示例：`t01-stock-card.md`、`t03-redis-cache.md`
 
 > 首次归档时由本 skill 创建 `docs/specx/wiki/` 目录和 `README.md`。
 
@@ -137,7 +137,7 @@ docs/specx/wiki/
 **分类：** {entities/features/decisions/components}
 **最后更新时间：** {YYYY-MM-DD}
 **关联需求：**
-- [T-xx](../{需求目录}/T-xx/00-子需求.md)
+- [t-xx](../{需求目录}/t-xx/00-子需求.md)
 
 ---
 
@@ -199,15 +199,15 @@ history:
 
 ## Step 6️⃣ 更新子需求目录状态
 
-在 `T-xx/` 下的 `README.md`（如果没有就创建）标注归档状态：
+在 `t-xx/` 下的 `README.md`（如果没有就创建）标注归档状态：
 
 ```markdown
-# T-{xx}-{子需求名称}
+# t-{xx}-{子需求名称}
 
 **状态：** ✅ 已归档
 **最后更新时间：** {YYYY-MM-DD}
 **Wiki 沉淀位置：**
-- [T-xx-{slug}](../wiki/{分类}/T-xx-{slug}.md)
+- [t-xx-{slug}](../wiki/{分类}/t-xx-{slug}.md)
 ```
 
 ---
@@ -218,7 +218,7 @@ history:
 [ ] 已读取全部子需求文档（00-子需求/clarify/spec/design/tasks）
 [ ] 判断了正确的 wiki 分类（entities/features/decisions/components）
 [ ] 每个提炼内容写成独立文件
-[ ] 文件名符合命名规则 {T-xx}-{slug}.md
+[ ] 文件名符合命名规则 {t-xx}-{slug}.md
 [ ] 更新了 README.md 索引（顶部插入新行）
 [ ] 标注了子需求目录为已归档
 [ ] 未污染原始文档（clarify/spec/design.md 未被修改）

package/skills/specx-clarify/SKILL.md

@@ -159,7 +159,7 @@ history:
 # {子需求名称}
 
 **所属原始需求：** {需求名称}
-**子需求目录：** T-{序号}-{名称}
+**子需求目录：** t-{序号}-{名称}
 
 ---
 
@@ -207,16 +207,16 @@ history:
 
 ### Step 2.5️⃣ 框架对齐（跳过已定义的）
 
-> ⚠️ 如果 `docs/specx/rule/` 下已有规范，只clarify 框架未定义的部分
+> ⚠️ 如果 `docs/specx/rules/` 下已有规范，只clarify 框架未定义的部分
 
 **动作：**
-1. 扫描 `docs/specx/rule/` 目录下的规范文件
+1. 扫描 `docs/specx/rules/` 目录下的规范文件
 2. 在 clarify-prd 中标注哪些是框架定义的（直接引用，不重复问）
 3. 只对「框架未定义」的部分提问
 
 **扫描范围：**
 ```
-docs/specx/rule/          → 项目框架规范（由项目自己组织子目录结构）
+docs/specx/rules/          → 项目框架规范（由项目自己组织子目录结构）
 ```
 
 **标注示例：**
@@ -252,7 +252,7 @@ history:
 
 # {子需求名称} — 规格说明书
 
-**所属子需求：** T-{序号}-{名称}
+**所属子需求：** t-{序号}-{名称}
 
 ---
 
@@ -505,7 +505,7 @@ history:
 - **两个文件同步更新** — clarify-prd 和 spec 是一体的
 - **clarify 迭代次数不限** — 可能是 1 次，可能是 10 次，都正常
 - **文档状态** — 新建时 `draft`，完成时 `review`
-- **框架已定义的不重复问** — 先扫描 `docs/specx/rule/`，直接引用，只clarify 未定义的部分
+- **框架已定义的不重复问** — 先扫描 `docs/specx/rules/`，直接引用，只clarify 未定义的部分
 - **避免污染上下文** — 框架规范在 rule/ 目录维护，不进clarify过程
 
 ---

package/skills/specx-create-rule/SKILL.md

@@ -36,7 +36,7 @@ tags: [specx, rule, convention, knowledge]
 | **替换** | 现有规则方向正确但表述不对 | 替换原文 |
 
 **判断步骤：**
-1. 读取 `docs/specx/rule/` 下所有现有规则
+1. 读取 `docs/specx/rules/` 下所有现有规则
 2. 与新规则对比：是否同类？是否矛盾？是否重复？
 3. 确定类型后，再执行对应动作
 
@@ -44,9 +44,9 @@ tags: [specx, rule, convention, knowledge]
 
 ## 规则发现路径
 
-### 路径 1：项目初始化时（docs/specx/rule 不存在）
+### 路径 1：项目初始化时（docs/specx/rules 不存在）
 
-**前置判断：** `docs/specx/rule/` 目录不存在
+**前置判断：** `docs/specx/rules/` 目录不存在
 
 **扫描步骤：**
 
@@ -56,7 +56,7 @@ tags: [specx, rule, convention, knowledge]
    - 目录结构约定
    - 常用工具库
    - 分层架构（MVVM / Clean / DDD）
-3. **推断规则** — 从扫描结果推断项目规范，写入 `docs/specx/rule/`
+3. **推断规则** — 从扫描结果推断项目规范，写入 `docs/specx/rules/`
 
 ### 路径 2：对话中途纠正（上下文沉淀）
 
@@ -65,16 +65,16 @@ tags: [specx, rule, convention, knowledge]
 **动作：**
 1. 理解用户纠正的本质（表面修改 vs 原则变更）
 2. 询问用户："是否需要把这个规则固化到项目的规范文档里？"
-3. 如用户确认，从纠正内容中提炼规则，写入 `docs/specx/rule/`
+3. 如用户确认，从纠正内容中提炼规则，写入 `docs/specx/rules/`
 
 ### 路径 3：用户明确提出规则
 
 **前置判断：** 用户说"加上 X 规则"、"规定 Y 这样做"等
 
 **动作：**
-1. **先判断** — 读取 `docs/specx/rule/` 下现有规则，确认是否已有相关规则
+1. **先判断** — 读取 `docs/specx/rules/` 下现有规则，确认是否已有相关规则
 2. 按判断结果执行（新增/冲突/过时/细化/替换）
-3. 更新 `docs/specx/rule/README.md`
+3. 更新 `docs/specx/rules/README.md`
 
 ### 路径 4：意图不明确
 
@@ -88,10 +88,10 @@ tags: [specx, rule, convention, knowledge]
 
 ## 输出结构
 
-### docs/specx/rule/ 目录结构
+### docs/specx/rules/ 目录结构
 
 ```
-docs/specx/rule/
+docs/specx/rules/
 ├── README.md          # 规则总览 & 索引
 ├── naming.md          # 命名规范
 ├── workflow.md        # 开发流程规范
@@ -99,7 +99,7 @@ docs/specx/rule/
 └── architecture.md    # 架构约定
 ```
 
-### docs/specx/rule/README.md 模板
+### docs/specx/rules/README.md 模板
 
 ```markdown
 # 项目规范

package/skills/specx-demystify/SKILL.md

@@ -22,12 +22,12 @@ history:
 
 | 输入 | 说明 |
 |------|------|
-| 原始需求来源 | 一个或多个文件，放入 `docs/specx/spaces/{yyyyMMdd}-{摘要}/Raws/` 目录，只读不修改 |
+| 原始需求来源 | 一个或多个文件，放入 `docs/specx/spaces/{yyyyMMdd}-{摘要}/raws/` 目录，只读不修改 |
 | 项目上下文 | 技术栈（iOS / KMP / Android）、现有框架规范、架构约定 |
 
-### Raws/ 目录规范
+### raws/ 目录规范
 
-所有原始来源文件（PRD、用户反馈、聊天记录、参考文献等）统一放入 `Raws/` 子目录，按分类前缀命名：
+所有原始来源文件（PRD、用户反馈、聊天记录、参考文献等）统一放入 `raws/` 子目录，按分类前缀命名：
 
 | 分类 | 前缀 | 说明 |
 |------|------|------|
@@ -51,7 +51,7 @@ Raws/
 
 | 输出 | 格式 | 说明 |
 |------|------|------|
-| 子需求目录集合 | `docs/specx/spaces/{yyyyMMdd}-{摘要}/T-{编号}-{名称}/00-子需求.md` | 每个子需求独立目录，含独立分析 |
+| 子需求目录集合 | `docs/specx/spaces/{yyyyMMdd}-{摘要}/t-{编号}-{名称}/00-子需求.md` | 每个子需求独立目录，含独立分析 |
 | 拆解决策记录 | 同一 docs 目录下的 `00-拆解策略.md`（可选） | 记录选择策略 A/B 的理由 |
 
 ## 4. 拆解策略（二选一）
@@ -90,7 +90,7 @@ Raws/
 - 检查项目是否已有数据模型规范、状态机模式、数据流约定（如已有项目的 Entity 定义、API 规范层）
 - 对已有抽象层：**不重复拆，直接引用**已有规范的路径/文档
 - 只拆「新增部分」——当前需求引入的新实体、新状态、新数据流
-- 示例：项目已有「商品数据模型」规范 → T-01 不再定义商品模型，改为「按项目现有商品模型扩展新字段」
+- 示例：项目已有「商品数据模型」规范 → t-01 不再定义商品模型，改为「按项目现有商品模型扩展新字段」
 
 **Step 1：识别新增抽象层**
 - 梳理需求涉及的所有「实体」（Entity）—— 有唯一标识、有生命周期的东西
@@ -107,24 +107,24 @@ Raws/
 
 ```
 抽象层：
-  T-01: 订单数据模型（Order Entity + 商品线 Item Value Object）
-  T-02: 订单状态机（待支付→已支付→已发货→已完成→已取消，含流转条件）
-  T-03: 订单数据加载/缓存/刷新机制（列表+详情的数据流）
+  t-01: 订单数据模型（Order Entity + 商品线 Item Value Object）
+  t-02: 订单状态机（待支付→已支付→已发货→已完成→已取消，含流转条件）
+  t-03: 订单数据加载/缓存/刷新机制（列表+详情的数据流）
 
 实现层：
-  T-04: 订单列表页（依赖 T-01, T-03）
-  T-05: 订单详情页（依赖 T-01, T-02, T-03）
-  T-06: 退款处理流程（依赖 T-01 订单状态机扩展）
-  T-07: 数据统计看板（依赖 T-01, T-03）
+  t-04: 订单列表页（依赖 t-01, t-03）
+  t-05: 订单详情页（依赖 t-01, t-02, t-03）
+  t-06: 退款处理流程（依赖 t-01 订单状态机扩展）
+  t-07: 数据统计看板（依赖 t-01, t-03）
 ```
 
 #### 依赖关系与执行顺序
 
 ```
 执行顺序：
-  Phase I（独立可并行）：T-01 → T-02 → T-03
-  Phase II（依赖 Phase I）：T-04, T-05, T-06（可并行）
-  Phase III（可选）：T-07
+  Phase I（独立可并行）：t-01 → t-02 → t-03
+  Phase II（依赖 Phase I）：t-04, t-05, t-06（可并行）
+  Phase III（可选）：t-07
 ```
 
 #### 🎯 策略 B：按业务模块拆
@@ -149,10 +149,10 @@ Raws/
 
 ## 6. 输出规范
 
-每个子需求目录 `/T-{编号}-{名称}/` 下：
+每个子需求目录 `/t-{编号}-{名称}/` 下：
 
 ```
-T-001-订单数据模型/
+t-001-订单数据模型/
 ├── 00-子需求.md          # 从原始需求摘录，可独立分析
 └── （后续 clarify/design/writing-plans 产物）
 ```
@@ -160,10 +160,10 @@ T-001-订单数据模型/
 `00-子需求.md` 模板：
 
 ```markdown
-## T-{编号}: {子需求名称}
+## t-{编号}: {子需求名称}
 
 ### 来源
-> 摘录自 `Raws/{文件名}`
+> 摘录自 `raws/{文件名}`
 
 {从原始需求中摘录相关段落}
 
@@ -171,8 +171,8 @@ T-001-订单数据模型/
 {明确本子需求包含什么、不包含什么}
 
 ### 依赖
-- 依赖：T-{编号1}, T-{编号2}
-- 被依赖：T-{编号3}, T-{编号4}
+- 依赖：t-{编号1}, t-{编号2}
+- 被依赖：t-{编号3}, t-{编号4}
 
 ### 类型
 - [ ] 抽象层（数据模型/状态机/数据流/领域规则）

package/{specx.js → src/specx.js}

@@ -6,12 +6,13 @@ import path from "path";
 import fs from "fs";
 import os from "os";
 import readline from "readline";
+import { execSync } from "child_process";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 // ─── Paths ───────────────────────────────────────────────────────
-const SPECX_HOME = process.env.SPECX_HOME || path.resolve(__dirname);
+const SPECX_HOME = process.env.SPECX_HOME || path.resolve(__dirname, "..");
 const SKILLS_DIR = path.join(SPECX_HOME, "skills");
 
 // ─── Registered CLI Targets ──────────────────────────────────────
@@ -28,6 +29,72 @@ const CLI_TARGETS = [
   },
 ];
 
+// ─── Helpers ──────────────────────────────────────────────────────
+function getPackageName() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(SPECX_HOME, "package.json"), "utf-8"));
+    return pkg.name;
+  } catch {
+    return "@culeo/specx";
+  }
+}
+
+// ─── Detect installed specx skills in a target dir ───────────────
+function findSpecxSkillsInDir(dir) {
+  if (!fs.existsSync(dir)) return [];
+  return fs.readdirSync(dir)
+    .filter((name) => {
+      const skillDir = path.join(dir, name);
+      return fs.statSync(skillDir).isDirectory() && fs.existsSync(path.join(skillDir, "SKILL.md")) && name.startsWith("specx-");
+    })
+    .sort();
+}
+
+// ─── Detect project-level .{claude,codex}/skills/ ────────────────
+function findProjectSpecxDirs(cwd) {
+  const results = [];
+  for (const target of CLI_TARGETS) {
+    const projectDir = path.join(cwd, `.${target.id}`, "skills");
+    const skills = findSpecxSkillsInDir(projectDir);
+    if (skills.length > 0) {
+      results.push({ targetId: target.id, label: target.label, dir: projectDir, skills });
+    } else if (fs.existsSync(projectDir)) {
+      // Dir exists but no specx skills — still a candidate for coverage
+      results.push({ targetId: target.id, label: target.label, dir: projectDir, skills: [] });
+    }
+  }
+  return results;
+}
+
+// ─── Copy skills from source to a destination ────────────────────
+function copySkillsToDir(srcDir, destDir) {
+  const skills = getAvailableSkills();
+  let installCount = 0;
+  let updateCount = 0;
+  for (const skillName of skills) {
+    const skillSrc = path.join(srcDir, skillName);
+    const skillDest = path.join(destDir, skillName);
+    if (!fs.existsSync(skillSrc)) {
+      console.log(`  ✖ ${skillName}: source not found, skipping`);
+      continue;
+    }
+    const existed = fs.existsSync(skillDest);
+    if (existed) {
+      fs.rmSync(skillDest, { recursive: true, force: true });
+    }
+    fs.mkdirSync(destDir, { recursive: true });
+    copyDirSync(skillSrc, skillDest);
+    if (existed) {
+      console.log(`  ↻ ${skillName} updated`);
+      updateCount++;
+    } else {
+      console.log(`  ✓ ${skillName} installed`);
+      installCount++;
+    }
+  }
+  return { installCount, updateCount };
+}
+
 // ─── Interactive Multi-Select ────────────────────────────────────
 function isTTY() {
   return process.stdin.isTTY;
@@ -205,27 +272,143 @@ program
       const finalDir = getFinalDir(targetId, isProject, projectDir);
 
       let installCount = 0;
+      let updateCount = 0;
       for (const skillName of skillsToInstall) {
         const destDir = path.join(finalDir, skillName);
-        if (fs.existsSync(destDir)) {
-          console.log(`  ○ ${target.label}: ${skillName} already installed`);
-          continue;
-        }
         const srcDir = path.join(SKILLS_DIR, skillName);
         if (!fs.existsSync(srcDir)) {
           console.log(`  ✖ ${skillName}: source not found, skipping`);
           continue;
         }
+        const existed = fs.existsSync(destDir);
+        if (existed) {
+          fs.rmSync(destDir, { recursive: true, force: true });
+        }
         fs.mkdirSync(finalDir, { recursive: true });
         copyDirSync(srcDir, destDir);
-        console.log(`  ✓ ${target.label}: ${skillName}`);
-        installCount++;
+        if (existed) {
+          console.log(`  ↻ ${target.label}: ${skillName} updated`);
+          updateCount++;
+        } else {
+          console.log(`  ✓ ${target.label}: ${skillName} installed`);
+          installCount++;
+        }
+      }
+
+      if (installCount > 0 || updateCount > 0) {
+        const parts = [];
+        if (installCount > 0) parts.push(`${installCount} installed`);
+        if (updateCount > 0) parts.push(`${updateCount} updated`);
+        console.log(`\n✓ ${parts.join(", ")} for ${target.label} (${isProject ? "project" : "user"} level)`);
       }
+    }
+  });
+
+// ─── Update Command ──────────────────────────────────────────────
+program
+  .command("update")
+  .description("Update specx CLI (npm) and re-install skills to all installed locations")
+  .action(async () => {
+    console.log("🔄 Updating specx CLI...");
+
+    // Step 1: Update the CLI itself via npm
+    const pkgName = getPackageName();
+    console.log(`  Running: npm update -g ${pkgName}...`);
+    try {
+      execSync(`npm update -g ${pkgName}`, { stdio: "inherit" });
+      console.log("  ✓ npm update complete");
+    } catch (e) {
+      console.error("  ✖ npm update failed. Try with sudo or check your npm setup.");
+      process.exit(1);
+    }
+
+    console.log("\n🔁 Re-installing specx skills...");
+
+    // Step 2: Re-install to all user-level targets that have specx skills installed
+    const userTargets = [];
+    for (const target of CLI_TARGETS) {
+      const targetDir = target.dir();
+      const installedSkills = findSpecxSkillsInDir(targetDir);
+      if (installedSkills.length > 0) {
+        userTargets.push({ target, skills: installedSkills });
+      } else {
+        console.log(`  ○ ${target.label}: no specx skills installed at user level, skipping`);
+      }
+    }
 
-      if (installCount > 0) {
-        console.log(`\n✓ Installed ${installCount} skill(s) to ${target.label} (${isProject ? "project" : "user"} level)`);
+    if (userTargets.length > 0) {
+      console.log("\n📦 User-level targets found:");
+      for (const ut of userTargets) {
+        console.log(`  ${ut.target.label} (${ut.skills.length} skills)`);
+      }
+      console.log("");
+
+      for (const ut of userTargets) {
+        const destDir = ut.target.dir();
+        console.log(`→ ${ut.target.label}...`);
+        const result = copySkillsToDir(SKILLS_DIR, destDir);
+        const parts = [];
+        if (result.installCount > 0) parts.push(`${result.installCount} installed`);
+        if (result.updateCount > 0) parts.push(`${result.updateCount} updated`);
+        console.log(`  ✓ ${parts.join(", ")} for ${ut.target.label} (user level)`);
       }
+    } else {
+      console.log("\n  No user-level specx skills found to update.");
     }
+
+    // Step 3: Check current working directory for project-level installations
+    const cwd = process.cwd();
+    const projectTargets = findProjectSpecxDirs(cwd);
+
+    if (projectTargets.length > 0) {
+      console.log(`\n📁 Project-level specx skills detected in ${cwd}:`);
+      for (const pt of projectTargets) {
+        console.log(`  ${pt.label} (${pt.skills.length} skills) — ${pt.dir}`);
+      }
+      console.log("");
+
+      if (isTTY()) {
+        // Interactive: let user choose which project locations to update
+        const items = projectTargets.map((pt) => ({
+          id: pt.targetId,
+          label: `${pt.label} (${pt.skills.length || 0} skills installed)`,
+          detected: true,
+        }));
+        const selected = await interactiveSelect(
+          items,
+          "📁 Select project-level locations to update:",
+          projectTargets.map((pt) => pt.targetId),
+          false
+        );
+
+        for (const pt of projectTargets) {
+          if (!selected.includes(pt.targetId)) {
+            console.log(`  ○ ${pt.label}: skipped`);
+            continue;
+          }
+          console.log(`→ ${pt.label}...`);
+          const result = copySkillsToDir(SKILLS_DIR, pt.dir);
+          const parts = [];
+          if (result.installCount > 0) parts.push(`${result.installCount} installed`);
+          if (result.updateCount > 0) parts.push(`${result.updateCount} updated`);
+          console.log(`  ✓ ${parts.join(", ")} for ${pt.label} (project level)`);
+        }
+      } else {
+        // Non-interactive: update all
+        for (const pt of projectTargets) {
+          console.log(`→ ${pt.label}...`);
+          const result = copySkillsToDir(SKILLS_DIR, pt.dir);
+          const parts = [];
+          if (result.installCount > 0) parts.push(`${result.installCount} installed`);
+          if (result.updateCount > 0) parts.push(`${result.updateCount} updated`);
+          console.log(`  ✓ ${parts.join(", ")} for ${pt.label} (project level)`);
+        }
+      }
+    } else {
+      console.log("\n  No project-level specx skills detected in current directory.");
+    }
+
+    console.log("\n✓ Update complete!");
   });
 
 // ─── Uninstall Command ───────────────────────────────────────────