xwang 0.0.6 → 0.0.7

package/assets/manifest.json

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

package/assets/skills/xwang/scripts/xwang-doc-lang-check.sh

@@ -0,0 +1,176 @@
+#!/bin/bash
+# xwang-doc-lang-check — validate language consistency across xwang-generated documents
+# Usage: xwang-doc-lang-check.sh [file-or-dir ...]
+# Exits 0 if all documents are consistent, 1 if any are mixed.
+# On mixed output, stdout contains a correction prompt in the primary language.
+
+set -euo pipefail
+
+# --- Language detection helpers ---
+
+# Count CJK unified ideographs in text
+count_cjk() {
+  local text="$1"
+  printf '%s' "$text" | perl -CS -ne 'BEGIN { $n=0 } while (/[\x{4e00}-\x{9fff}]/g) { $n++ } END { print $n }'
+}
+
+# Count alphabetic ASCII words
+count_words() {
+  local text="$1"
+  printf '%s' "$text" | grep -oE '[a-zA-Z]+' | wc -l | tr -d ' '
+}
+
+# Detect dominant language: "zh" or "en"
+detect_language() {
+  local text="$1"
+  local cjk words
+  cjk=$(count_cjk "$text")
+  words=$(count_words "$text")
+  if [ "$cjk" -gt "$words" ]; then
+    echo "zh"
+  else
+    echo "en"
+  fi
+}
+
+# --- Markdown helpers ---
+
+is_markdown() {
+  local file="$1"
+  case "$file" in
+    *.md|*.mdx) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# Check a single markdown file for language consistency.
+# Outputs issues to stderr and a correction prompt to stdout when inconsistent.
+check_file() {
+  local file="$1"
+  local title=""
+  local lead=""
+  local primary=""
+  local section_name=""
+  local section_body=""
+  local issues=()
+
+  flush_section() {
+    if [ -z "$section_name" ]; then
+      return
+    fi
+    local full_section="${section_name}"$'\n'"${section_body}"
+    if [ -z "$primary" ]; then
+      lead="${lead}${full_section}"
+      primary=$(detect_language "$lead")
+    else
+      local section_lang
+      section_lang=$(detect_language "$full_section")
+      if [ "$section_lang" != "$primary" ]; then
+        issues+=("section \"$section_name\": $section_lang, expected $primary")
+      fi
+    fi
+    section_name=""
+    section_body=""
+  }
+
+  while IFS= read -r line || [ -n "$line" ]; do
+    if [[ "$line" =~ ^#[[:space:]] ]]; then
+      # Level-1 heading: treat as title / lead context
+      title="${line#*# }"
+      lead="${lead}${line}"$'\n'
+      continue
+    fi
+
+    if [[ "$line" =~ ^##[[:space:]] ]]; then
+      flush_section
+      section_name="${line##*## }"
+      section_body=""
+      continue
+    fi
+
+    if [ -n "$section_name" ]; then
+      section_body="${section_body}${line}"$'\n'
+    else
+      # Content before the first section contributes to the lead
+      lead="${lead}${line}"$'\n'
+    fi
+  done < "$file"
+
+  flush_section
+
+  # If no sections at all, treat the whole file as one document
+  if [ -z "$primary" ]; then
+    primary=$(detect_language "$lead")
+  fi
+
+  if [ ${#issues[@]} -eq 0 ]; then
+    echo "OK: $file language is consistent ($primary)"
+    return 0
+  fi
+
+  echo "MIXED-LANGUAGE: $file (${#issues[@]} issue(s))" >&2
+  for issue in "${issues[@]}"; do
+    echo "  - $issue" >&2
+  done
+
+  if [ "$primary" = "zh" ]; then
+    cat <<'EOF'
+上述文档存在中英文混用问题。项目上下文为中文，请将整份文档统一改写为中文，保持所有章节（包括但不限于标题、Problem Statement、Solution、User Stories、Implementation Decisions、Testing Decisions、Out of Scope、Further Notes、Why、What Changes、Capabilities、Impact 等）语言一致。
+EOF
+  else
+    cat <<'EOF'
+The document above has mixed languages. The project context is English. Please rewrite the entire document in English, keeping all sections (including but not limited to title, Problem Statement, Solution, User Stories, Implementation Decisions, Testing Decisions, Out of Scope, Further Notes, Why, What Changes, Capabilities, Impact, etc.) consistent in language.
+EOF
+  fi
+
+  return 1
+}
+
+# --- Argument collection ---
+
+declare -a FILES=()
+
+if [ $# -eq 0 ]; then
+  echo "Usage: $0 [file-or-dir ...]" >&2
+  exit 2
+fi
+
+for arg in "$@"; do
+  if [ -f "$arg" ]; then
+    FILES+=("$arg")
+  elif [ -d "$arg" ]; then
+    while IFS= read -r f; do
+      if is_markdown "$f"; then
+        FILES+=("$f")
+      fi
+    done < <(find "$arg" -type f \( -name '*.md' -o -name '*.mdx' \) \
+      ! -path '*/node_modules/*' \
+      ! -path '*/.git/*' \
+      ! -path '*/dist/*' \
+      ! -path '*/.claude/worktrees/*' \
+      2>/dev/null || true)
+  else
+    echo "WARNING: not found: $arg" >&2
+  fi
+done
+
+if [ ${#FILES[@]} -eq 0 ]; then
+  echo "No markdown documents found to check." >&2
+  exit 0
+fi
+
+mixed=0
+for file in "${FILES[@]}"; do
+  if ! check_file "$file"; then
+    mixed=$((mixed + 1))
+  fi
+done
+
+if [ "$mixed" -eq 0 ]; then
+  echo "OK: all ${#FILES[@]} document(s) have consistent language"
+  exit 0
+else
+  echo "" >&2
+  echo "Total: $mixed / ${#FILES[@]} document(s) have mixed languages." >&2
+  exit 1
+fi

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

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

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

@@ -58,10 +58,18 @@ fi
   - **暂不归档**：不执行归档，保留当前 `phase: archive` 状态，等待用户稍后再次调用 `/xwang-archive`
 - [ ] 只有用户选择「确认归档」后才继续 Step 3。
 
-### Step 3：标记归档状态并校验完整性
+### Step 3：标记归档状态、校验完整性与 PRD 语言一致性
 
 - [ ] 调用 `"$XWANG_STATE" set <name> archived true`，在 change 仍在 `openspec/changes/<name>/` 时把 `.xwang.yaml` 标记为已归档。
 - [ ] **归档完整性守护**：调用 `"$XWANG_GUARD" <name> archive` 校验归档退出条件（`archived: true`、必要文档存在且 tasks 已勾选）。
+- [ ] **PRD 语言一致性守护**：定位当前 change 对应的 PRD 文件（常见路径如 `docs/mattpocock/<name>-prd.md`、`docs/<name>-prd.md` 或 `<name>-prd.md`）。如存在，运行：
+
+  ```bash
+  "$XWANG_DOC_LANG_CHECK" <prd-file>
+  ```
+
+  若脚本报告 `MIXED-LANGUAGE`，将其 stdout 中的修正提示词展示给用户，**停止归档**，等待用户修正 PRD 后重新触发 `/xwang-archive`。只有脚本退出 `0` 才继续下一步。
+
 - [ ] 如需，在 PRD 和 plan 文件前置元数据中标注 `archived-with: <name>` 和 `status: archived`。
 
 ### Step 4：执行归档

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

@@ -105,8 +105,18 @@ grilling 确认完成后、生成 PRD 前，**必须**执行 PRD 拆分预检并
 
 ### Step 2：生成 PRD
 
-- [ ] 用户确认后，调用 `/to-prd` 生成**中文** PRD（遵循 to-prd 的 PRD 模板），无需额外用户确认。
+- [ ] 用户确认后，调用 `/to-prd` 生成 PRD（遵循 to-prd 的 PRD 模板），无需额外用户确认。
 - [ ] 将 PRD 写入 `docs/mattpocock/<name>-prd.md`；如果 grilling 过程中名称有调整，使用最终生成的名称。
+- [ ] **PRD 语言一致性守护**：写入后运行语言检测脚本：
+
+  ```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_DOC_LANG_CHECK" docs/mattpocock/<name>-prd.md
+  ```
+
+  若脚本报告 `MIXED-LANGUAGE`，将其 stdout 中的修正提示词追加到下一次 `/to-prd` 请求中，重新生成并写入 PRD，重复检测直到脚本退出 `0`。
+
 - [ ] **如果 Step 1a 结论为「保持为一个 change」，在 PRD 中显式写入“不拆分原因”章节。**
 
 ### Step 3：创建 OpenSpec change

package/package.json

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