xwang 0.0.1

package/assets/skills/xwang-design/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: xwang-design
+description: 启动 xwang 项目阶段2：深度设计，明确需求并同步产生PRD，通过 OpenSpec 创建 change 结构（proposal + design + tasks）
+---
+
+# xwang-design
+
+## Quick start
+
+当用户触发 xwang 阶段2时：
+
+1. 调用 `/grill-with-docs` 围绕需求目标、范围、用户、约束、验收标准等逐层追问，同时对照现有领域模型和文档（CONTEXT.md、ADRs）挑战术语、澄清冲突，直到达成共识。
+2. **PRD 拆分预检（阻塞点）**：grilling 结束后，基于已澄清信息评估是否需要拆分为多个 change。若 PRD 包含多个独立 capability、模块、用户路径或明显里程碑，必须暂停并让用户选择拆分方案；确认后才继续。
+3. grilling 结束后，根据需求内容自己总结一个简洁的 kebab-case 需求名称 `<name>`，用于生成 `docs/mattpocock/<name>-prd.md`。
+4. 创建 `docs/mattpocock/` 目录（如不存在）。
+5. **需求澄清完成确认（阻塞点）**：向用户输出一份结构化的需求摘要（目标、范围、用户、核心行为、边界情况、非功能性需求、依赖与限制），等待用户明确确认或提出修改；未确认前不得生成 PRD 或创建 OpenSpec change。
+6. 用户确认后，调用 `/to-prd` 基于对话上下文合成**中文** PRD。
+7. 将生成的 PRD 内容写入 `docs/mattpocock/<name>-prd.md`。
+8. 直接调用 `/openspec-new-change`：以 `<name>` 作为 change 名称，将 PRD 的中文内容作为 change 文档/上下文创建 change，过程中无需用户确认；若 `/openspec-new-change` 流程中出现任何确认提示（如“是否继续创建 proposal.md？”），直接代为确认并继续，不得将确认问题抛给用户；**要求 `/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述，包括但不限于 `proposal.md`、`design.md`、`tasks.md` 以及 `specs/*/spec.md`**。
+9. **初始化 xwang 状态**：调用 `"$XWANG_STATE" init <name> full`，在 `openspec/changes/<name>/.xwang.yaml` 创建状态文件（起始 phase 为 `design`）。
+10. **记录 design 文件**：调用 `"$XWANG_STATE" set <name> design_doc docs/mattpocock/<name>-prd.md`，将 PRD 路径写入状态。
+11. **阶段出口守护（design → build）**：调用 `"$XWANG_GUARD" <name> design --apply` 校验 design 阶段退出条件，通过后会自动将 `.xwang.yaml` 的 `phase` 推进到 `build`。
+12. **自动进入 build 阶段（full 模式）**：向用户简要汇报 PRD 保存路径、change 名称、状态文件路径后，直接调用 `/xwang-build` 继续阶段3，无需等待用户确认。
+
+    汇报示例：
+
+    ```
+    xwang-design 已完成。
+    - PRD: docs/mattpocock/<name>-prd.md
+    - Change: <name>
+    - 状态文件: openspec/changes/<name>/.xwang.yaml
+    - 下一步：正在自动进入 xwang-build 阶段...
+    ```
+
+## Workflows
+
+开始前先定位 xwang 脚本：
+
+```bash
+XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+if [ -z "$XWANG_ENV" ]; then
+  echo "ERROR: xwang-env.sh not found. Ensure the xwang skill is installed." >&2
+  return 1
+fi
+. "$XWANG_ENV"
+```
+
+### Step 1：需求澄清
+
+- [ ] 确认用户要启动 xwang 阶段2（关键词：xwang-design、xwang 阶段2、开始 xwang）。
+- [ ] 调用 `/grill-with-docs`，从用户视角深挖：目标用户、核心问题、预期行为、边界情况、非功能性需求、依赖与限制；并对照现有 CONTEXT.md/ADRs 挑战术语、澄清冲突，必要时实时更新文档。
+- [ ] grilling 过程中持续追问，直到形成清晰的需求理解。
+
+### Step 1a：PRD 拆分预检（阻塞点）
+
+grilling 结束后、生成 PRD 前，基于已澄清信息评估是否需要拆分为多个 change。
+
+- [ ] 输出候选拆分清单。每项包含：建议 change 名称、目标与范围边界、明确非目标、依赖关系/推荐顺序、核心验收场景。
+- [ ] 满足任一条件时推荐拆分：
+  - PRD 包含多个可独立设计、构建、验证、归档的 capability
+  - 涉及多个模块或用户路径，且其中一部分可独立交付
+  - 存在明显分阶段里程碑
+  - 预计会产生多个 delta spec 或超过 3 个大任务
+  - 任一部分失败或延期不应阻塞其他部分进入后续阶段
+- [ ] **必须使用当前平台可用的用户输入/确认机制暂停并等待用户选择**：
+  - **创建多个 OpenSpec changes**：按候选拆分逐个创建独立 change
+  - **保持为一个 change**：继续单 change 流程，并在 PRD 中记录不拆分原因
+  - **调整拆分方案后继续**：用户说明调整方向后，重新输出候选拆分清单并再次确认
+- [ ] 用户选择「创建多个 changes」后，当前 `/xwang-design` 调用只完成拆分确认；随后按用户确认的顺序分别进入每个拆分项的 `/xwang-design`，每个拆分项默认跳过本预检。
+- [ ] 未得到用户明确选择前，不得生成 PRD 或创建 OpenSpec change。
+
+### Step 1b：需求澄清完成确认（阻塞点）
+
+- [ ] grilling 结束后，根据需求核心内容自己生成一个简洁的 kebab-case 名称（如 `Auth Flow` → `auth-flow`）作为 `<name>`，直接使用无需确认。
+- [ ] 使用 `mkdir -p docs/mattpocock` 确保目录存在。
+- [ ] 向用户输出结构化的**需求确认摘要**（建议包含：目标、范围、目标用户、核心行为、边界情况、非功能性需求、依赖与限制）。
+- [ ] **必须使用当前平台可用的用户输入/确认机制暂停并等待用户确认需求澄清完成**。若用户提出修改，根据反馈调整摘要并再次确认，直到达成共识。
+- [ ] **未确认前不得调用 `/to-prd`，不得生成 PRD，不得创建 OpenSpec change**。
+
+### Step 2：生成 PRD
+
+- [ ] 用户确认后，调用 `/to-prd` 生成**中文** PRD（遵循 to-prd 的 PRD 模板），无需额外用户确认。
+- [ ] 将 PRD 写入 `docs/mattpocock/<name>-prd.md`；如果 grilling 过程中名称有调整，使用最终生成的名称。
+
+### Step 3：创建 OpenSpec change
+
+- [ ] 直接调用 `/openspec-new-change` 创建 change：change 名称为 `<name>`，文档/描述使用 PRD 的中文内容，过程中不再询问用户确认；若其流程中出现确认提示（如“是否继续创建 proposal.md？”），直接代为确认并继续。
+- [ ] **`/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述，包括但不限于 `proposal.md`、`design.md`、`tasks.md` 以及 `specs/*/spec.md`**。
+
+### Step 4：初始化状态并推进
+
+- [ ] **初始化 xwang 状态**：调用 `"$XWANG_STATE" init <name> full`。
+- [ ] **记录 design 文件**：调用 `"$XWANG_STATE" set <name> design_doc docs/mattpocock/<name>-prd.md`。
+- [ ] **阶段出口守护（design → build）**：调用 `"$XWANG_GUARD" <name> design --apply` 校验退出条件并自动推进 `phase` 到 `build`。
+
+### Step 5：自动进入 build
+
+- [ ] 向用户简要汇报 PRD 保存路径、change 名称、状态文件路径。
+- [ ] **自动进入 build 阶段（full 模式）**：直接调用 `/xwang-build` 继续阶段3，无需等待用户确认。
+
+## Advanced features
+
+- **更新已有 PRD**：如果 `docs/mattpocock/<name>-prd.md` 已存在，先读取现有内容，结合新的 grilling 结果更新后再写入。
+- **未配置 issue tracker**：`to-prd` 可能依赖 `/setup-matt-pocock-skills` 提供的词汇；如未配置，仍按 to-prd 模板在本地生成 PRD，无需发布到 issue tracker。

package/assets/skills/xwang-hotfix/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: xwang-hotfix
+description: xwang 快速修复路径：跳过 design 阶段，直接 open → build → verify → archive。适用于 bug 修复、不新增 capability、改动范围小的场景。当用户触发 xwang-hotfix、快速修复、hotfix 或 bugfix 时使用。
+---
+
+# xwang-hotfix
+
+快速 bug fix 工作流：open → build → verify → archive。跳过 design 阶段，适用于行为修复、不涉及新 capability 设计的场景。
+
+**适用条件**（必须全部满足）：
+1. 修复已有功能的 bug，不新增 capability
+2. 不涉及接口变更或架构调整
+3. 改动范围可预估（通常 ≤ 2 个文件）
+
+**不适用**：如修复过程发现需要架构调整，应升级为完整 `/xwang` 流程。
+
+## 流程
+
+开始前先定位 xwang 脚本：
+
+```bash
+XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+if [ -z "$XWANG_ENV" ]; then
+  echo "ERROR: xwang-env.sh not found. Ensure the xwang skill is installed." >&2
+  return 1
+fi
+. "$XWANG_ENV"
+```
+
+### Step 1：快速开启
+
+- [ ] 确认用户要触发 hotfix（关键词：xwang-hotfix、hotfix、bugfix、快速修复）。
+- [ ] 用户未提供 change 名称时，根据修复主题生成一个简洁的 kebab-case 名称 `<name>`。
+- [ ] 直接调用 `/openspec-new-change` 创建精简 change：
+  - `proposal.md`：问题描述 + 根因分析 + 修复目标
+  - `design.md`：修复方案（1 个即可，无需多方案对比）
+  - `tasks.md`：修复任务清单
+  - 通常**无需 delta spec**（除非修复改变了已有 spec 的验收场景）
+- [ ] **`/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述**。
+- [ ] 调用 `"$XWANG_STATE" init <name> quick` 初始化状态（`workflow: quick`，`phase: build`，跳过 design）。
+
+### Step 2：直接构建
+
+- [ ] 读取 `openspec/changes/<name>/tasks.md`。
+- [ ] 默认使用 `build_mode: direct`、`tdd_mode: direct`、`isolation: branch`，无需用户决策。
+- [ ] 记录选择：
+  - `"$XWANG_STATE" set <name> build_mode direct`
+  - `"$XWANG_STATE" set <name> tdd_mode direct`
+  - `"$XWANG_STATE" set <name> isolation branch`
+- [ ] 按 `feature/YYYYMMDD/<name>` 创建分支。
+- [ ] 对每个未完成任务：
+  - 修改代码
+  - 运行格式化命令（如项目有）
+  - 运行相关测试确认通过
+  - 将 `tasks.md` 中对应 `- [ ]` 改为 `- [x]`
+  - 提交代码，`commit message`：`fix: <简述修复>`
+- [ ] 全部任务完成后，显式运行项目测试和构建命令。
+- [ ] 出现崩溃、异常、测试失败或构建失败时，立即加载 Superpowers `systematic-debugging` 技能；根因调查完成前不得实施源码修复。
+
+### Step 3：根因消除检查
+
+- [ ] 读取 `proposal.md` 中的 bug 描述和根因。
+- [ ] 确认问题代码已消除。
+- [ ] 如根因未消除，回到 Step 2 继续修复。
+- [ ] 如根因指向深层架构问题或需要接口变更，**暂停并等待用户确认**是否升级为完整 `/xwang` 流程。
+
+### Step 4：验证
+
+- [ ] 默认选择保持分支不变（稍后处理），无需用户确认：调用 `"$XWANG_STATE" set <name> branch_status handled`。
+- [ ] **阶段出口守护（build → verify）**：调用 `"$XWANG_GUARD" <name> build --apply` 校验 build 阶段退出条件，通过后会自动将 `phase` 推进到 `verify`。
+- [ ] 调用 `/xwang-verify` 继续验证。
+
+### Step 5：归档
+
+- [ ] `/xwang-verify` 将 phase 推进到 `archive` 后，用户可调用 `/xwang-archive` 完成归档。
+
+## 升级条件
+
+满足以下任一条件时，停止 hotfix，升级为完整 `/xwang`：
+
+| 条件 | 说明 |
+|------|------|
+| 改动涉及 3+ 文件 | 超出单点修复范围 |
+| 架构变更 | 新模块、新接口、新依赖 |
+| 数据库 schema 变更 | 结构性调整 |
+| 引入新的 public API | 修复产生了新的对外接口 |
+| 修复范围超出单一函数/模块 | 需要多处协调修改 |
+
+满足升级条件时**必须使用当前平台可用的用户输入/确认机制暂停并等待用户确认**。用户确认升级后：
+
+```bash
+"$XWANG_STATE" set <name> workflow full
+"$XWANG_STATE" set <name> phase design
+```
+
+然后调用 `/xwang-design` 补充设计并走完整流程。
+
+## 退出条件
+
+- Bug 已修复，测试通过
+- change 已推进到 `phase: archive`
+- 用户通过 `/xwang-archive` 完成归档

package/assets/skills/xwang-open/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: xwang-open
+description: 在启动新工作前检测用户意图并报告 xwang 项目是否存在未完成任务。支持识别 hotfix/tweak 等预设路径。当用户说 "xwang-open"、启动 xwang、打开 xwang，或在开始前想检查 xwang 任务状态时使用。
+---
+
+# xwang-open
+
+## 快速开始
+
+当用户想要打开/启动 xwang 或检查项目状态时：
+
+1. **意图检测（Preset 判定）**：先判断用户输入是否命中 hotfix / tweak 等预设路径。
+   - 用户明确描述为 bug fix / 热修复 + 满足 hotfix 条件 → 直接调用 `/xwang-hotfix`
+   - 用户明确描述为文案/配置/文档/prompt 小调整 + 满足 tweak 条件 → 直接调用 `/xwang-tweak`
+   - 未命中 preset → 继续步骤 2
+2. **定位 xwang 脚本并运行未完成任务检测**：先 source `xwang-env.sh` 定位脚本路径，再调用 `"$XWANG_OPEN_CHECK"` 扫描活跃 change、Git dirty worktree、TODO/FIXME 注释等。
+
+   ```bash
+   XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/../*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+   if [ -z "$XWANG_ENV" ]; then
+     echo "ERROR: xwang-env.sh not found. Ensure the xwang skill is installed." >&2
+     return 1
+   fi
+   . "$XWANG_ENV"
+   "$XWANG_OPEN_CHECK" --text
+   ```
+3. 汇总检测结果。
+4. 询问用户是继续已有任务、切换到其他任务，还是创建新任务。
+
+## 检测清单
+
+通过 `"$XWANG_OPEN_CHECK"` 自动检查以下来源（脚本路径通过 `xwang-env.sh` 动态定位，避免硬编码 `.claude`）：
+
+- [ ] 尚未归档的 OpenSpec / xwang change 产物（读取 `.xwang.yaml` 的 `phase`、`archived` 等字段）
+- [ ] Git 工作区改动（未提交文件 / stash / staged）
+- [ ] 最近改动文件中的 TODO / FIXME / XXX 注释
+
+暂不自动检查、需人工补充的来源：
+
+- [ ] Claude 任务列表中的活跃任务
+- [ ] 项目任务或计划文件（例如 `TASKS.md`、`PLAN.md`）
+- [ ] 与项目关联的 GitHub issues / PRs（如有权限访问）
+
+## 报告格式
+
+返回简洁的状态块：
+
+```
+xwang-open 状态: <ready | blocked | has-unfinished-work>
+
+发现的未完成任务信号:
+- <来源>: <简要描述>
+
+建议下一步:
+- <continue-existing-task | start-fresh | wait-for-input>
+
+说明:
+- ready / 无未完成任务时，主入口 /xwang 将直接进入 xwang-design，无需再次确认。
+- 若输入命中 hotfix / tweak preset，将直接分发到对应快速路径。
+```
+
+## Workflows
+
+### Step 0：意图检测与 Preset 判定
+
+**Preset 检测优先级最高**。先根据用户输入判断是否需要走快速路径：
+
+- **hotfix 判定**（需同时满足）：
+  - 用户明确描述为 bug fix / 热修复 / 修复某个问题
+  - 修复已有功能，不新增 capability
+  - 不涉及接口变更或架构调整
+  - 改动范围可预估（通常 ≤ 2 个文件）
+  - **命中后行为**：直接调用 `/xwang-hotfix`，不再执行普通 open 流程
+
+- **tweak 判定**（需同时满足）：
+  - 用户明确描述为文案/配置/文档/prompt 小调整 / 小优化
+  - 不新增 capability
+  - 不改变架构
+  - 不涉及接口变化
+  - 通常不超过 3 个任务
+  - **命中后行为**：直接调用 `/xwang-tweak`，不再执行普通 open 流程
+
+- **未命中 preset**：继续 Step 1 的普通 open 流程
+
+### Step 1：未完成任务扫描
+
+调用 `"$XWANG_OPEN_CHECK"` 自动扫描：
+
+- [ ] **活跃 xwang change**：遍历 `openspec/changes/*/.xwang.yaml`，跳过 `archived: true`，根据 `phase` 判断当前状态：
+  - `design` 且无 `design_doc` → 需要继续 `/xwang-design`
+  - `build` 且 `tasks.md` 有未勾选任务 → 需要继续 `/xwang-build`
+  - `verify` 且 `branch_status` 或 `verification_report` 未完成 → 需要继续 `/xwang-verify`
+  - `archive` → 需要 `/xwang-archive`
+- [ ] **Git dirty worktree**：运行 `git status --short`、`git diff --stat`、`git diff --cached --stat`、`git ls-files --others --exclude-standard`
+- [ ] **TODO / FIXME / XXX 注释**：扫描最近 7 天内变更过的文件
+- [ ] 将脚本输出作为状态报告的核心内容。
+
+### Step 2：报告与下一步建议
+
+- [ ] 汇总所有检测到的信号。
+- [ ] 返回 `xwang-open 状态` 报告。
+- [ ] 根据状态给出建议下一步：继续已有任务、切换到其他任务、创建新任务，或已分发到 preset skill。
+
+## 说明
+
+- 本 skill 通过 `"$XWANG_OPEN_CHECK"`（由 `xwang-env.sh` 动态定位）自动检测活跃 change、Git dirty worktree 和 TODO/FIXME 注释。
+- 检测结果仅报告状态，不会自动修改文件或创建 change。
+- Claude 任务列表、项目任务文件、GitHub issues/PRs 等来源目前仍需人工检查或后续扩展脚本支持。

package/assets/skills/xwang-open/scripts/xwang-open-check.sh

@@ -0,0 +1,197 @@
+#!/bin/bash
+# xwang-open-check — detect unfinished work in an xwang project
+# Usage: xwang-open-check.sh [options]
+#   --json    Output machine-readable JSON
+#   --text    Output human-readable text (default)
+
+set -euo pipefail
+
+# --- Colors ---
+red() { echo -e "\033[31m$1\033[0m" >&2; }
+yellow() { echo -e "\033[33m$1\033[0m" >&2; }
+green() { echo -e "\033[32m$1\033[0m" >&2; }
+
+# --- Options ---
+OUTPUT="text"
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --json) OUTPUT="json" ;;
+    --text) OUTPUT="text" ;;
+    *) red "Unknown option: $1" >&2; exit 1 ;;
+  esac
+  shift
+done
+
+# --- Helpers ---
+file_nonempty() { [ -f "$1" ] && [ -s "$1" ]; }
+
+yaml_field() {
+  field="$1"
+  yaml_file="$2"
+  if [ -f "$yaml_file" ]; then
+    grep "^${field}:" "$yaml_file" 2>/dev/null | sed "s/^${field}: *//" | head -1 || true
+  fi
+}
+
+count_unchecked_tasks() {
+  file="$1"
+  if [ -f "$file" ]; then
+    grep -c '^[[:space:]]*- \[ \]' "$file" 2>/dev/null || echo "0"
+  else
+    echo "0"
+  fi
+}
+
+# --- Detect active changes ---
+CHANGES_DIR="openspec/changes"
+JSON_ENTRIES=()
+TEXT_LINES=()
+SIGNAL_COUNT=0
+
+# 1. Active xwang changes
+if [ -d "$CHANGES_DIR" ]; then
+  while IFS= read -r change_dir; do
+    [ -z "$change_dir" ] && continue
+    change_name=$(basename "$change_dir")
+    xwang_file="$change_dir/.xwang.yaml"
+    tasks_file="$change_dir/tasks.md"
+
+    if [ ! -f "$xwang_file" ]; then
+      continue
+    fi
+
+    phase=$(yaml_field "phase" "$xwang_file")
+    workflow=$(yaml_field "workflow" "$xwang_file")
+    archived=$(yaml_field "archived" "$xwang_file")
+    design_doc=$(yaml_field "design_doc" "$xwang_file")
+    plan=$(yaml_field "plan" "$xwang_file")
+    verification_report=$(yaml_field "verification_report" "$xwang_file")
+    branch_status=$(yaml_field "branch_status" "$xwang_file")
+
+    # Skip fully archived changes
+    if [ "$archived" = "true" ]; then
+      continue
+    fi
+
+    status="active"
+    details="phase=${phase:-unknown}, workflow=${workflow:-unknown}"
+    action=""
+
+    case "$phase" in
+      design)
+        if [ -z "$design_doc" ] || [ "$design_doc" = "null" ]; then
+          details="${details}, design_doc pending"
+          action="continue /xwang-design"
+        else
+          status="ready-to-build"
+          details="${details}, design_doc=${design_doc}"
+          action="proceed to /xwang-build"
+        fi
+        ;;
+      build)
+        unchecked=$(count_unchecked_tasks "$tasks_file")
+        if [ "$unchecked" -gt 0 ]; then
+          details="${details}, ${unchecked} unchecked tasks"
+          action="continue /xwang-build"
+        else
+          status="ready-to-verify"
+          details="${details}, all tasks done"
+          action="proceed to /xwang-verify"
+        fi
+        ;;
+      verify)
+        if [ "$branch_status" != "handled" ]; then
+          details="${details}, branch_status=${branch_status:-pending}"
+          action="continue /xwang-verify"
+        elif [ -z "$verification_report" ] || [ "$verification_report" = "null" ]; then
+          details="${details}, verification_report pending"
+          action="continue /xwang-verify"
+        else
+          status="ready-to-archive"
+          details="${details}, verification_report=${verification_report}"
+          action="proceed to /xwang-archive"
+        fi
+        ;;
+      archive)
+        status="ready-to-archive"
+        action="proceed to /xwang-archive"
+        ;;
+      *)
+        action="inspect manually"
+        ;;
+    esac
+
+    JSON_ENTRIES+=("{\"source\":\"xwang-change\",\"name\":\"$change_name\",\"status\":\"$status\",\"phase\":\"${phase:-unknown}\",\"details\":\"$details\",\"action\":\"$action\"}")
+    TEXT_LINES+=("  - [xwang-change] $change_name: $status ($details) → $action")
+    SIGNAL_COUNT=$((SIGNAL_COUNT + 1))
+  done < <(find "$CHANGES_DIR" -maxdepth 1 -mindepth 1 -type d -print)
+fi
+
+# 2. Git dirty worktree
+GIT_DIRTY=0
+GIT_DETAILS=""
+if git rev-parse --git-dir >/dev/null 2>&1; then
+  untracked=$(git ls-files --others --exclude-standard 2>/dev/null | wc -l | tr -d ' ')
+  tracked_unstaged=$(git diff --name-only 2>/dev/null | wc -l | tr -d ' ')
+  tracked_staged=$(git diff --cached --name-only 2>/dev/null | wc -l | tr -d ' ')
+
+  if [ "$untracked" -gt 0 ] || [ "$tracked_unstaged" -gt 0 ] || [ "$tracked_staged" -gt 0 ]; then
+    GIT_DIRTY=1
+    GIT_DETAILS="untracked=${untracked}, unstaged=${tracked_unstaged}, staged=${tracked_staged}"
+    JSON_ENTRIES+=("{\"source\":\"git-dirty-worktree\",\"status\":\"dirty\",\"details\":\"$GIT_DETAILS\",\"action\":\"commit or stash changes before starting new work\"}")
+    TEXT_LINES+=("  - [git-dirty-worktree] $GIT_DETAILS → commit or stash before starting new work")
+    SIGNAL_COUNT=$((SIGNAL_COUNT + 1))
+  fi
+fi
+
+# 3. TODO / FIXME / XXX in recent changes
+TODO_COUNT=0
+if git rev-parse --git-dir >/dev/null 2>&1; then
+  # Check files changed in last 7 days or currently dirty
+  recent_files=$(git log --since="7 days ago" --name-only --pretty=format: 2>/dev/null | sort -u | grep -v '^$' || true)
+  if [ -n "$recent_files" ]; then
+    TODO_COUNT=$(echo "$recent_files" | xargs grep -Hn -E 'TODO|FIXME|XXX' 2>/dev/null | wc -l | tr -d ' ')
+  fi
+fi
+
+if [ "$TODO_COUNT" -gt 0 ]; then
+  JSON_ENTRIES+=("{\"source\":\"todo-comments\",\"status\":\"found\",\"details\":\"${TODO_COUNT} TODO/FIXME/XXX in recent files\",\"action\":\"review before starting new work\"}")
+  TEXT_LINES+=("  - [todo-comments] ${TODO_COUNT} TODO/FIXME/XXX in recent files → review before starting new work")
+  SIGNAL_COUNT=$((SIGNAL_COUNT + 1))
+fi
+
+# --- Output ---
+if [ "$OUTPUT" = "json" ]; then
+  echo "{\"ready\":$([ "$SIGNAL_COUNT" -eq 0 ] && echo "true" || echo "false"),\"signals\":["
+  first=1
+  for entry in "${JSON_ENTRIES[@]:-}"; do
+    [ -z "$entry" ] && continue
+    if [ "$first" -eq 1 ]; then
+      first=0
+    else
+      echo ","
+    fi
+    echo -n "  $entry"
+  done
+  echo ""
+  echo "]}"
+else
+  echo "=== xwang-open status ==="
+  if [ "$SIGNAL_COUNT" -eq 0 ]; then
+    green "READY — no unfinished work detected"
+    echo ""
+    echo "建议下一步: start-fresh → /xwang-design"
+  else
+    yellow "HAS-UNFINISHED-WORK — ${SIGNAL_COUNT} signal(s) found"
+    echo ""
+    echo "发现的未完成任务信号:"
+    for line in "${TEXT_LINES[@]:-}"; do
+      [ -z "$line" ] && continue
+      echo "$line"
+    done
+    echo ""
+    echo "建议下一步: continue-existing-task"
+  fi
+fi
+
+exit 0

package/assets/skills/xwang-tweak/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: xwang-tweak
+description: xwang 轻量小改动路径：跳过 design 阶段，直接 open → lightweight build → light verify → archive。适用于文案、配置、文档或 prompt 的局部优化。当用户触发 xwang-tweak、tweak、小改动或局部优化时使用。
+---
+
+# xwang-tweak
+
+轻量小改动工作流：open → lightweight build → light verify → archive。跳过 design 阶段，适用于非 bug 的小范围变更。
+
+**适用条件**（必须全部满足）：
+1. 不新增 capability
+2. 不改变架构
+3. 不涉及接口变化
+4. 通常不超过 3 个任务
+
+**不适用**：如变更过程中发现需要 capability、架构或接口调整，应升级为完整 `/xwang` 流程。
+
+## 流程
+
+开始前先定位 xwang 脚本：
+
+```bash
+XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+if [ -z "$XWANG_ENV" ]; then
+  echo "ERROR: xwang-env.sh not found. Ensure the xwang skill is installed." >&2
+  return 1
+fi
+. "$XWANG_ENV"
+```
+
+### Step 1：快速开启
+
+- [ ] 确认用户要触发 tweak（关键词：xwang-tweak、tweak、小改动、局部优化）。
+- [ ] 用户未提供 change 名称时，根据变更主题生成一个简洁的 kebab-case 名称 `<name>`。
+- [ ] 直接调用 `/openspec-new-change` 创建精简 change：
+  - `proposal.md`：变更动机 + 目标 + 范围
+  - `design.md`：简短实现说明（无需方案对比）
+  - `tasks.md`：不超过 3 个任务
+  - **无需 delta spec**（一旦需要，升级为完整 `/xwang`）
+- [ ] **`/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述**。
+- [ ] 调用 `"$XWANG_STATE" init <name> tweak` 初始化状态（`workflow: tweak`，`phase: build`，跳过 design）。
+
+### Step 2：轻量构建
+
+- [ ] 读取 `openspec/changes/<name>/tasks.md`。
+- [ ] 默认使用 `build_mode: direct`、`tdd_mode: direct`、`isolation: branch`，无需用户决策。
+- [ ] 记录选择：
+  - `"$XWANG_STATE" set <name> build_mode direct`
+  - `"$XWANG_STATE" set <name> tdd_mode direct`
+  - `"$XWANG_STATE" set <name> isolation branch`
+- [ ] 按 `feature/YYYYMMDD/<name>` 创建分支。
+- [ ] 对每个未完成任务：
+  - 根据任务描述修改目标文件
+  - 运行格式化命令（如项目有）
+  - 运行相关测试确认通过
+  - 将 `tasks.md` 中对应 `- [ ]` 改为 `- [x]`
+  - 提交代码，`commit message`：`tweak: <简述变更>`
+- [ ] 全部任务完成后，显式运行项目测试和构建命令。
+- [ ] 出现崩溃、异常、测试失败或构建失败时，立即加载 Superpowers `systematic-debugging` 技能；根因调查完成前不得实施源码修复。
+
+### Step 3：轻量验证
+
+- [ ] 默认选择保持分支不变（稍后处理），无需用户确认：调用 `"$XWANG_STATE" set <name> branch_status handled`。
+- [ ] **阶段出口守护（build → verify）**：调用 `"$XWANG_GUARD" <name> build --apply` 校验 build 阶段退出条件，通过后会自动将 `phase` 推进到 `verify`。
+- [ ] 调用 `/xwang-verify` 继续验证。
+- [ ] 若 `/xwang-verify` 的规模评估进入 `full` 模式，停止 tweak，**暂停并等待用户确认**是否升级为完整 `/xwang` 流程。
+
+### Step 4：归档
+
+- [ ] `/xwang-verify` 将 phase 推进到 `archive` 后，用户可调用 `/xwang-archive` 完成归档。
+
+## 升级条件
+
+满足以下任一条件时，停止 tweak，升级为完整 `/xwang`：
+
+| 条件 | 说明 |
+|------|------|
+| 改动涉及 5+ 文件 | 超出小改动范围 |
+| 多模块协调修改 | 需要跨组件协调 |
+| 需要新增测试用例 5+ | 变更复杂度上升 |
+| 配置项新增或删除 | 非值修改的配置变更 |
+| 需要新增 capability | 超出局部优化 |
+| 需要 delta spec | 影响了已有规格 |
+
+满足升级条件时**必须使用当前平台可用的用户输入/确认机制暂停并等待用户确认**。用户确认升级后：
+
+```bash
+"$XWANG_STATE" set <name> workflow full
+"$XWANG_STATE" set <name> phase design
+```
+
+然后调用 `/xwang-design` 补充设计并走完整流程。
+
+## 退出条件
+
+- 小改动已完成，测试通过
+- change 已推进到 `phase: archive`
+- 未新增 capability、架构调整或接口变化
+- 用户通过 `/xwang-archive` 完成归档