xwang 0.0.10 → 0.0.11

package/assets/manifest.json

@@ -6,6 +6,7 @@
     "xwang/scripts/xwang-state.sh",
     "xwang/scripts/xwang-guard.sh",
     "xwang/scripts/xwang-doc-lang-check.sh",
+    "xwang/scripts/xwang-create-change.sh",
     "xwang-open/SKILL.md",
     "xwang-open/scripts/xwang-open-check.sh",
     "xwang-design/SKILL.md",

package/assets/skills/xwang/scripts/xwang-create-change.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+# xwang-create-change — create an OpenSpec change directory scaffold with a given name.
+# Usage: xwang-create-change.sh <change-name> <workflow> [schema]
+# Creates openspec/changes/<change-name>/ with .openspec.yaml and minimal artifact stubs.
+# Exits 0 on success, 1 on error.
+
+set -euo pipefail
+
+name="${1:-}"
+workflow="${2:-}"
+schema="${3:-spec-driven}"
+
+if [ -z "$name" ] || [ -z "$workflow" ]; then
+  echo "Usage: $0 <change-name> <workflow> [schema]" >&2
+  exit 2
+fi
+
+# Validate name using the same rules as xwang-state/xwang-guard
+if [[ "$name" =~ \.\. ]]; then
+  echo "ERROR: Change name cannot contain '..'" >&2
+  exit 1
+fi
+if printf '%s' "$name" | perl -ne 'exit 1 if m{[/\\\s\0-\x1F\x7F;|&$`()<>{}[\]*'"'"'"!#@%^=+~]}; exit 0'; then
+  : # valid
+else
+  echo "ERROR: Invalid change name: '$name'" >&2
+  echo "Avoid: / \\ spaces control chars and shell metacharacters" >&2
+  exit 1
+fi
+
+# Determine project root
+find_project_root() {
+  if [ -n "${XWANG_PROJECT_ROOT:-}" ]; then
+    printf '%s' "$XWANG_PROJECT_ROOT"
+    return 0
+  fi
+  local git_root
+  git_root=$(git rev-parse --show-toplevel 2>/dev/null || true)
+  if [ -n "$git_root" ]; then
+    printf '%s' "$git_root"
+    return 0
+  fi
+  local dir="$PWD"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/openspec/changes" ]; then
+      printf '%s' "$dir"
+      return 0
+    fi
+    dir=$(dirname "$dir")
+  done
+  printf '%s' "$PWD"
+}
+
+PROJECT_ROOT=$(find_project_root)
+CHANGE_DIR="$PROJECT_ROOT/openspec/changes/$name"
+
+if [ -d "$CHANGE_DIR" ]; then
+  echo "ERROR: change directory already exists: $CHANGE_DIR" >&2
+  exit 1
+fi
+
+mkdir -p "$CHANGE_DIR"
+
+# .openspec.yaml
+cat > "$CHANGE_DIR/.openspec.yaml" <<EOF
+schema: $schema
+created: $(date -u +%Y-%m-%d)
+EOF
+
+# Minimal stubs; the caller (xwang-design/hotfix/tweak) should overwrite with real content.
+case "$workflow" in
+  full)
+    cat > "$CHANGE_DIR/proposal.md" <<'EOF'
+## Why
+
+## What Changes
+
+## Capabilities
+
+### New Capabilities
+
+无。
+
+### Modified Capabilities
+
+## Impact
+EOF
+    cat > "$CHANGE_DIR/design.md" <<'EOF'
+## Context
+
+## Goals / Non-Goals
+
+**Goals:**
+
+**Non-Goals:**
+
+## Decisions
+
+## Risks / Trade-offs
+EOF
+    cat > "$CHANGE_DIR/tasks.md" <<'EOF'
+## Tasks
+
+- [ ] Task 1
+EOF
+    ;;
+  quick|hotfix)
+    cat > "$CHANGE_DIR/proposal.md" <<'EOF'
+## Why
+
+## What Changes
+
+## Impact
+EOF
+    cat > "$CHANGE_DIR/design.md" <<'EOF'
+## Context
+
+## Solution
+
+## Risks / Trade-offs
+EOF
+    cat > "$CHANGE_DIR/tasks.md" <<'EOF'
+## Tasks
+
+- [ ] Task 1
+EOF
+    ;;
+  tweak)
+    cat > "$CHANGE_DIR/proposal.md" <<'EOF'
+## Why
+
+## What Changes
+
+## Impact
+EOF
+    cat > "$CHANGE_DIR/design.md" <<'EOF'
+## Solution
+EOF
+    cat > "$CHANGE_DIR/tasks.md" <<'EOF'
+## Tasks
+
+- [ ] Task 1
+EOF
+    ;;
+  *)
+    echo "ERROR: unknown workflow: $workflow" >&2
+    exit 1
+    ;;
+esac
+
+echo "$CHANGE_DIR"

package/assets/skills/xwang/scripts/xwang-env.sh

@@ -76,6 +76,17 @@ if [ -z "${XWANG_DOC_LANG_CHECK:-}" ]; then
 fi
 export XWANG_DOC_LANG_CHECK
 
+# Locate xwang-create-change.sh using the same approach.
+if [ -z "${XWANG_CREATE_CHANGE:-}" ]; then
+  XWANG_CREATE_CHANGE_SIBLING="${XWANG_SCRIPT_DIR}/xwang-create-change.sh"
+  if [ -f "$XWANG_CREATE_CHANGE_SIBLING" ]; then
+    XWANG_CREATE_CHANGE="$(cd "$(dirname "$XWANG_CREATE_CHANGE_SIBLING")" && pwd)/$(basename "$XWANG_CREATE_CHANGE_SIBLING")"
+  else
+    XWANG_CREATE_CHANGE="$(locate_by_glob '*/xwang/scripts/xwang-create-change.sh' "${SEARCH_DIRS[@]}" 2>/dev/null || true)"
+  fi
+fi
+export XWANG_CREATE_CHANGE
+
 if [ -z "$XWANG_OPEN_CHECK" ] || [ ! -f "$XWANG_OPEN_CHECK" ]; then
   echo "WARNING: xwang-open-check.sh not found" >&2
 fi
@@ -87,3 +98,7 @@ fi
 if [ -z "$XWANG_DOC_LANG_CHECK" ] || [ ! -f "$XWANG_DOC_LANG_CHECK" ]; then
   echo "WARNING: xwang-doc-lang-check.sh not found" >&2
 fi
+
+if [ -z "$XWANG_CREATE_CHANGE" ] || [ ! -f "$XWANG_CREATE_CHANGE" ]; then
+  echo "WARNING: xwang-create-change.sh not found" >&2
+fi

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

@@ -127,8 +127,17 @@ grilling 确认完成后、生成 PRD 前，**必须**执行 PRD 拆分预检并
 
 ### 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`**。
+- [ ] 使用 xwang 自带脚本创建中文 change 目录和 OpenSpec 骨架（绕过 `/openspec-new-change` 的英文 kebab-case 限制，避免中文文件被删除或重命名）：
+
+  ```bash
+  XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+  . "$XWANG_ENV"
+  "$XWANG_CREATE_CHANGE" <name> full
+  ```
+
+- [ ] 基于 PRD 内容覆盖 `openspec/changes/<name>/proposal.md`、`design.md`、`tasks.md`，确保所有 artifact 使用中文表述。
+- [ ] 如需生成 delta spec，创建 `openspec/changes/<name>/specs/<name>/spec.md`。
+- [ ] **中文名称保护**：任何情况下不得删除、重命名或迁移已创建的中文文件（包括 `openspec/changes/<中文名>/` 和 `docs/mattpocock/<中文名>-prd.md`）。如果创建过程中报错，停止并报告，而不是改为英文。
 
 ### Step 4：初始化状态并推进
 

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

@@ -30,13 +30,21 @@ fi
 ### Step 1：快速开启
 
 - [ ] 确认用户要触发 hotfix（关键词：xwang-hotfix、hotfix、bugfix、快速修复）。
-- [ ] 用户未提供 change 名称时，根据修复主题生成一个简洁的 kebab-case 名称 `<name>`。
-- [ ] 直接调用 `/openspec-new-change` 创建精简 change：
+- [ ] 用户未提供 change 名称时，根据修复主题生成一个简洁的中文名称 `<name>`（如 `登录按钮失效修复`）。
+- [ ] 使用 xwang 自带脚本创建中文 change 目录和 OpenSpec 骨架（绕过 `/openspec-new-change` 的 kebab-case 限制）：
+
+  ```bash
+  XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+  . "$XWANG_ENV"
+  "$XWANG_CREATE_CHANGE" <name> hotfix
+  ```
+
+- [ ] 基于修复内容覆盖 `openspec/changes/<name>/proposal.md`、`design.md`、`tasks.md`：
   - `proposal.md`：问题描述 + 根因分析 + 修复目标
   - `design.md`：修复方案（1 个即可，无需多方案对比）
   - `tasks.md`：修复任务清单
   - 通常**无需 delta spec**（除非修复改变了已有 spec 的验收场景）
-- [ ] **`/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述**。
+- [ ] **`openspec/changes/<name>/` 下的所有文档/artifact 必须使用中文表述**。
 - [ ] 调用 `"$XWANG_STATE" init <name> quick` 初始化状态（`workflow: quick`，`phase: build`，跳过 design）。
 
 ### Step 2：直接构建

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

@@ -31,13 +31,21 @@ fi
 ### Step 1：快速开启
 
 - [ ] 确认用户要触发 tweak（关键词：xwang-tweak、tweak、小改动、局部优化）。
-- [ ] 用户未提供 change 名称时，根据变更主题生成一个简洁的 kebab-case 名称 `<name>`。
-- [ ] 直接调用 `/openspec-new-change` 创建精简 change：
+- [ ] 用户未提供 change 名称时，根据变更主题生成一个简洁的中文名称 `<name>`（如 `文案优化`）。
+- [ ] 使用 xwang 自带脚本创建中文 change 目录和 OpenSpec 骨架（绕过 `/openspec-new-change` 的 kebab-case 限制）：
+
+  ```bash
+  XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+  . "$XWANG_ENV"
+  "$XWANG_CREATE_CHANGE" <name> tweak
+  ```
+
+- [ ] 基于变更内容覆盖 `openspec/changes/<name>/proposal.md`、`design.md`、`tasks.md`：
   - `proposal.md`：变更动机 + 目标 + 范围
   - `design.md`：简短实现说明（无需方案对比）
   - `tasks.md`：不超过 3 个任务
   - **无需 delta spec**（一旦需要，升级为完整 `/xwang`）
-- [ ] **`/openspec-new-change` 生成的所有文档/artifact 必须使用中文表述**。
+- [ ] **`openspec/changes/<name>/` 下的所有文档/artifact 必须使用中文表述**。
 - [ ] 调用 `"$XWANG_STATE" init <name> tweak` 初始化状态（`workflow: tweak`，`phase: build`，跳过 design）。
 
 ### Step 2：轻量构建

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xwang",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "xwang CLI",
   "keywords": [
     "xwang",