feat: add TraeCn to sync/release/CI tool chain (second slice)

- sync-skills.sh: add Codex→TraeCn sync with YAML frontmatter + path rewrite
- check-skills-sync.sh: add TraeCn mirror validation
- check-version-consistency.sh: include TraeCn SOPIFY_VERSION in checks
- check-readme-links.py: add TraeCn to VERSION_HEADERS; fix section list
- .githooks/pre-commit: add TraeCn to managed_paths, is_release_relevant_file, git add
- test_release_hooks.py: add TraeCn fixture and version propagation assertion

Author: Li-Sanze

.githooks/pre-commit

@@ -24,10 +24,14 @@ snapshot_managed_release_paths() {
     "Codex/Skills/EN/AGENTS.md"
     "Claude/Skills/CN/CLAUDE.md"
     "Claude/Skills/EN/CLAUDE.md"
+    "TraeCn/Skills/CN/user_rules/sopify.md"
+    "TraeCn/Skills/EN/user_rules/sopify.md"
     "Codex/Skills/CN/skills/sopify"
     "Codex/Skills/EN/skills/sopify"
     "Claude/Skills/CN/skills/sopify"
     "Claude/Skills/EN/skills/sopify"
+    "TraeCn/Skills/CN/skills/sopify"
+    "TraeCn/Skills/EN/skills/sopify"
   )
   local path
   local src
@@ -89,7 +93,7 @@ trap on_exit EXIT
 is_release_relevant_file() {
   local path="$1"
   case "$path" in
-    runtime/*|installer/*|Codex/Skills/*|Claude/Skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
+    runtime/*|installer/*|Codex/Skills/*|Claude/Skills/*|TraeCn/Skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
       return 0
       ;;
     scripts/sopify_runtime.py|scripts/go_plan_runtime.py|scripts/model_compare_runtime.py|scripts/clarification_bridge_runtime.py|scripts/decision_bridge_runtime.py|scripts/develop_checkpoint_runtime.py|scripts/sync-runtime-assets.sh|scripts/check-runtime-smoke.sh|scripts/release-sync.sh|scripts/release-preflight.sh|scripts/sync-skills.sh|scripts/check-skills-sync.sh|scripts/check-version-consistency.sh)
@@ -160,10 +164,14 @@ git -C "$ROOT_DIR" add \
   Codex/Skills/EN/AGENTS.md \
   Claude/Skills/CN/CLAUDE.md \
   Claude/Skills/EN/CLAUDE.md \
+  TraeCn/Skills/CN/user_rules/sopify.md \
+  TraeCn/Skills/EN/user_rules/sopify.md \
   Codex/Skills/CN/skills/sopify \
   Codex/Skills/EN/skills/sopify \
   Claude/Skills/CN/skills/sopify \
-  Claude/Skills/EN/skills/sopify
+  Claude/Skills/EN/skills/sopify \
+  TraeCn/Skills/CN/skills/sopify \
+  TraeCn/Skills/EN/skills/sopify
 
 cat >"$STATE_FILE" <<EOF
 RELEASE_VERSION=$RELEASE_VERSION

scripts/check-readme-links.py

@@ -21,6 +21,8 @@
     ROOT / "Codex/Skills/EN/AGENTS.md",
     ROOT / "Claude/Skills/CN/CLAUDE.md",
     ROOT / "Claude/Skills/EN/CLAUDE.md",
+    ROOT / "TraeCn/Skills/CN/user_rules/sopify.md",
+    ROOT / "TraeCn/Skills/EN/user_rules/sopify.md",
 )
 LINK_PATTERN = re.compile(r"(?<!\!)\[[^\]]+\]\(([^)]+)\)")
 HEADING_PATTERN = re.compile(r"^(#{1,6})\s+(.*)$")
@@ -33,6 +35,7 @@
 EXPECTED_LEVEL2_SECTIONS = {
     README_FILES[0]: (
         "Why Sopify?",
+        "What You Get After Install",
         "Quick Start",
         "Configuration",
         "Command Reference",
@@ -46,6 +49,7 @@
     ),
     README_FILES[1]: (
         "为什么选择 Sopify？",
+        "安装后你会得到什么",
         "快速开始",
         "配置说明",
         "命令参考",

scripts/check-skills-sync.sh

@@ -9,8 +9,8 @@ usage() {
   cat <<'EOF'
 Usage: scripts/check-skills-sync.sh
 
-Check whether Claude/* mirrors Codex/* for Sopify skills.
-For header files, Claude-specific config/helper paths are expected to be rewritten from ~/.codex/* to ~/.claude/*.
+Check whether Claude/* and TraeCn/* mirror Codex/* for Sopify skills.
+For header files, host-specific config/helper paths are expected to be rewritten.
 On mismatch, run:
   bash scripts/sync-skills.sh
 EOF
@@ -32,6 +32,22 @@ render_expected_claude_header() {
     "$source_file" >"$target_file"
 }
 
+TRAE_CN_FRONTMATTER="---
+alwaysApply: true
+---"
+
+render_expected_trae_cn_header() {
+  local source_file="$1"
+  local target_file="$2"
+  {
+    printf '%s\n\n' "$TRAE_CN_FRONTMATTER"
+    sed \
+      -e 's#~/.codex/sopify\.config\.yaml#~/.trae-cn/sopify.config.yaml#g' \
+      -e 's#~/.codex/sopify/#~/.trae-cn/sopify/#g' \
+      "$source_file"
+  } >"$target_file"
+}
+
 check_lang() {
   local lang="$1"
   local codex_dir="$ROOT_DIR/Codex/Skills/$lang"
@@ -53,13 +69,37 @@ check_lang() {
   fi
 }
 
+check_trae_cn_lang() {
+  local lang="$1"
+  local codex_dir="$ROOT_DIR/Codex/Skills/$lang"
+  local trae_cn_dir="$ROOT_DIR/TraeCn/Skills/$lang"
+  local diff_file="$TMP_DIR/${lang}_trae_cn.diff"
+
+  render_expected_trae_cn_header "$codex_dir/AGENTS.md" "$TMP_DIR/${lang}_trae_cn.expected.md"
+
+  if ! diff -u "$TMP_DIR/${lang}_trae_cn.expected.md" "$trae_cn_dir/user_rules/sopify.md" >"$diff_file"; then
+    echo "[$lang] Header file mismatch: Codex/Skills/$lang/AGENTS.md != TraeCn/Skills/$lang/user_rules/sopify.md"
+    head -n 40 "$diff_file"
+    status=1
+  fi
+
+  if ! diff -ru -x .DS_Store -x Thumbs.db "$codex_dir/skills/sopify" "$trae_cn_dir/skills/sopify" >"$diff_file"; then
+    echo "[$lang] Skill directory mismatch: Codex/Skills/$lang/skills/sopify != TraeCn/Skills/$lang/skills/sopify"
+    head -n 60 "$diff_file"
+    status=1
+  fi
+}
+
 check_lang "CN"
 check_lang "EN"
 
+check_trae_cn_lang "CN"
+check_trae_cn_lang "EN"
+
 if [[ "$status" -ne 0 ]]; then
   echo
   echo "Sync check failed. Run: bash scripts/sync-skills.sh"
   exit 1
 fi
 
-echo "Sync check passed: Claude/* is aligned with Codex/*."
+echo "Sync check passed: Claude/* and TraeCn/* are aligned with Codex/*."

scripts/check-version-consistency.sh

@@ -10,6 +10,8 @@ CODEX_CN="$ROOT_DIR/Codex/Skills/CN/AGENTS.md"
 CODEX_EN="$ROOT_DIR/Codex/Skills/EN/AGENTS.md"
 CLAUDE_CN="$ROOT_DIR/Claude/Skills/CN/CLAUDE.md"
 CLAUDE_EN="$ROOT_DIR/Claude/Skills/EN/CLAUDE.md"
+TRAE_CN_CN="$ROOT_DIR/TraeCn/Skills/CN/user_rules/sopify.md"
+TRAE_CN_EN="$ROOT_DIR/TraeCn/Skills/EN/user_rules/sopify.md"
 
 usage() {
   cat <<'EOF'
@@ -18,7 +20,7 @@ Usage: scripts/check-version-consistency.sh
 Validate version consistency across:
   - README.md / README.zh-CN.md version badges
   - Latest released version in CHANGELOG.md
-  - SOPIFY_VERSION headers in Codex/Claude CN/EN files
+  - SOPIFY_VERSION headers in Codex/Claude/TraeCn CN/EN files
 
 Exit codes:
   0: all checks passed
@@ -39,6 +41,8 @@ required_files=(
   "$CODEX_EN"
   "$CLAUDE_CN"
   "$CLAUDE_EN"
+  "$TRAE_CN_CN"
+  "$TRAE_CN_EN"
 )
 
 for file in "${required_files[@]}"; do
@@ -131,6 +135,8 @@ codex_cn_version="$(extract_sopify_version "$CODEX_CN")"
 codex_en_version="$(extract_sopify_version "$CODEX_EN")"
 claude_cn_version="$(extract_sopify_version "$CLAUDE_CN")"
 claude_en_version="$(extract_sopify_version "$CLAUDE_EN")"
+trae_cn_cn_version="$(extract_sopify_version "$TRAE_CN_CN")"
+trae_cn_en_version="$(extract_sopify_version "$TRAE_CN_EN")"
 
 if [[ -z "$codex_cn_version" ]]; then
   add_error "Codex/Skills/CN/AGENTS.md: missing SOPIFY_VERSION header."
@@ -144,12 +150,18 @@ fi
 if [[ -z "$claude_en_version" ]]; then
   add_error "Claude/Skills/EN/CLAUDE.md: missing SOPIFY_VERSION header."
 fi
+if [[ -z "$trae_cn_cn_version" ]]; then
+  add_error "TraeCn/Skills/CN/user_rules/sopify.md: missing SOPIFY_VERSION header."
+fi
+if [[ -z "$trae_cn_en_version" ]]; then
+  add_error "TraeCn/Skills/EN/user_rules/sopify.md: missing SOPIFY_VERSION header."
+fi
 
-header_versions=("$codex_cn_version" "$codex_en_version" "$claude_cn_version" "$claude_en_version")
+header_versions=("$codex_cn_version" "$codex_en_version" "$claude_cn_version" "$claude_en_version" "$trae_cn_cn_version" "$trae_cn_en_version")
 first_header_version="${header_versions[0]}"
 for version in "${header_versions[@]}"; do
   if [[ -n "$version" && "$version" != "$first_header_version" ]]; then
-    add_error "Header SOPIFY_VERSION mismatch: $codex_cn_version / $codex_en_version / $claude_cn_version / $claude_en_version."
+    add_error "Header SOPIFY_VERSION mismatch: codex=$codex_cn_version/$codex_en_version, claude=$claude_cn_version/$claude_en_version, trae-cn=$trae_cn_cn_version/$trae_cn_en_version."
     break
   fi
 done

scripts/sync-skills.sh

@@ -7,12 +7,17 @@ usage() {
   cat <<'EOF'
 Usage: scripts/sync-skills.sh
 
-Sync Sopify skill content from Codex/* to Claude/*:
+Sync Sopify skill content from Codex/* to Claude/* and TraeCn/*:
   - Codex/Skills/CN/AGENTS.md -> Claude/Skills/CN/CLAUDE.md
-    (auto-rewrite ~/.codex/* Claude-specific config/helper paths)
+    (auto-rewrite ~/.codex/* to ~/.claude/* paths)
   - Codex/Skills/EN/AGENTS.md -> Claude/Skills/EN/CLAUDE.md
-    (auto-rewrite ~/.codex/* Claude-specific config/helper paths)
+    (auto-rewrite ~/.codex/* to ~/.claude/* paths)
+  - Codex/Skills/CN/AGENTS.md -> TraeCn/Skills/CN/user_rules/sopify.md
+    (auto-rewrite ~/.codex/* to ~/.trae-cn/* paths; prepend alwaysApply frontmatter)
+  - Codex/Skills/EN/AGENTS.md -> TraeCn/Skills/EN/user_rules/sopify.md
+    (auto-rewrite ~/.codex/* to ~/.trae-cn/* paths; prepend alwaysApply frontmatter)
   - Codex/Skills/{CN,EN}/skills/sopify/* -> Claude/Skills/{CN,EN}/skills/sopify/*
+  - Codex/Skills/{CN,EN}/skills/sopify/* -> TraeCn/Skills/{CN,EN}/skills/sopify/*
 EOF
 }
 
@@ -31,6 +36,23 @@ render_claude_header() {
     "$source_file" >"$target_file"
 }
 
+TRAE_CN_FRONTMATTER="---
+alwaysApply: true
+---"
+
+render_trae_cn_header() {
+  local source_file="$1"
+  local target_file="$2"
+
+  {
+    printf '%s\n\n' "$TRAE_CN_FRONTMATTER"
+    sed \
+      -e 's#~/.codex/sopify\.config\.yaml#~/.trae-cn/sopify.config.yaml#g' \
+      -e 's#~/.codex/sopify/#~/.trae-cn/sopify/#g' \
+      "$source_file"
+  } >"$target_file"
+}
+
 sync_lang() {
   local lang="$1"
   local codex_dir="$ROOT_DIR/Codex/Skills/$lang"
@@ -60,7 +82,33 @@ sync_lang() {
   rsync -a --delete --exclude .DS_Store --exclude Thumbs.db "$codex_dir/skills/sopify/" "$claude_dir/skills/sopify/"
 }
 
+sync_trae_cn_lang() {
+  local lang="$1"
+  local codex_dir="$ROOT_DIR/Codex/Skills/$lang"
+  local trae_cn_dir="$ROOT_DIR/TraeCn/Skills/$lang"
+
+  if [[ ! -f "$codex_dir/AGENTS.md" ]]; then
+    echo "Missing source file: $codex_dir/AGENTS.md" >&2
+    exit 1
+  fi
+
+  mkdir -p "$trae_cn_dir/user_rules"
+
+  if [[ ! -d "$codex_dir/skills/sopify" ]]; then
+    echo "Missing source directory: $codex_dir/skills/sopify" >&2
+    exit 1
+  fi
+
+  mkdir -p "$trae_cn_dir/skills/sopify"
+
+  render_trae_cn_header "$codex_dir/AGENTS.md" "$trae_cn_dir/user_rules/sopify.md"
+  rsync -a --delete --exclude .DS_Store --exclude Thumbs.db "$codex_dir/skills/sopify/" "$trae_cn_dir/skills/sopify/"
+}
+
 sync_lang "CN"
 sync_lang "EN"
 
-echo "Synced Codex -> Claude for CN and EN skill bundles."
+sync_trae_cn_lang "CN"
+sync_trae_cn_lang "EN"
+
+echo "Synced Codex -> Claude and Codex -> TraeCn for CN and EN skill bundles."

tests/test_check_readme_links.py

@@ -70,6 +70,22 @@ def _minimal_agents(version: str, *, claude: bool, english: bool) -> str:
     )
 
 
+def _minimal_trae_cn_rules(version: str, *, english: bool) -> str:
+    body = "Note: ~/.trae-cn/sopify/" if english else "说明：~/.trae-cn/sopify/"
+    return textwrap.dedent(
+        f"""\
+        ---
+        alwaysApply: true
+        ---
+
+        <!-- SOPIFY_VERSION: {version} -->
+        # Sopify Rules
+
+        {body}
+        """
+    )
+
+
 def _configure_module(module, root: Path) -> None:
     readme_sections_primary = module.EXPECTED_LEVEL2_SECTIONS[module.README_FILES[0]]
     readme_sections_zh = module.EXPECTED_LEVEL2_SECTIONS[module.README_FILES[1]]
@@ -93,6 +109,8 @@ def _configure_module(module, root: Path) -> None:
         root / "Codex/Skills/EN/AGENTS.md",
         root / "Claude/Skills/CN/CLAUDE.md",
         root / "Claude/Skills/EN/CLAUDE.md",
+        root / "TraeCn/Skills/CN/user_rules/sopify.md",
+        root / "TraeCn/Skills/EN/user_rules/sopify.md",
     )
     module.EXPECTED_LEVEL2_SECTIONS = {
         module.README_FILES[0]: readme_sections_primary,
@@ -130,6 +148,8 @@ def _init_fixture(root: Path, module, *, broken_workflow_link: bool = False, reo
     _write(root / "Codex/Skills/EN/AGENTS.md", _minimal_agents(VERSION, claude=False, english=True))
     _write(root / "Claude/Skills/CN/CLAUDE.md", _minimal_agents(VERSION, claude=True, english=False))
     _write(root / "Claude/Skills/EN/CLAUDE.md", _minimal_agents(VERSION, claude=True, english=True))
+    _write(root / "TraeCn/Skills/CN/user_rules/sopify.md", _minimal_trae_cn_rules(VERSION, english=False))
+    _write(root / "TraeCn/Skills/EN/user_rules/sopify.md", _minimal_trae_cn_rules(VERSION, english=True))
 
     _write(
         root / "README.md",

tests/test_release_hooks.py

@@ -99,6 +99,22 @@ def _minimal_agents(version: str, *, claude: bool, english: bool) -> str:
     )
 
 
+def _minimal_trae_cn_rules(version: str, *, english: bool) -> str:
+    body = "Note: ~/.trae-cn/sopify/" if english else "说明：~/.trae-cn/sopify/"
+    return textwrap.dedent(
+        f"""\
+        ---
+        alwaysApply: true
+        ---
+
+        <!-- SOPIFY_VERSION: {version} -->
+        # Sopify Rules
+
+        {body}
+        """
+    )
+
+
 def _unreleased_body(changelog_text: str) -> str:
     start = changelog_text.index("## [Unreleased]") + len("## [Unreleased]")
     end = changelog_text.find("\n## [", start)
@@ -148,6 +164,11 @@ def _init_release_hook_fixture(root: Path, *, missing_claude_targets: bool = Fal
         _write(root / "Claude/Skills/CN/skills/sopify/SKILL.md", "# skill\n")
         _write(root / "Claude/Skills/EN/skills/sopify/SKILL.md", "# skill\n")
 
+        _write(root / "TraeCn/Skills/CN/user_rules/sopify.md", _minimal_trae_cn_rules(old_version, english=False))
+        _write(root / "TraeCn/Skills/EN/user_rules/sopify.md", _minimal_trae_cn_rules(old_version, english=True))
+        _write(root / "TraeCn/Skills/CN/skills/sopify/SKILL.md", "# skill\n")
+        _write(root / "TraeCn/Skills/EN/skills/sopify/SKILL.md", "# skill\n")
+
     _write(root / "runtime/gate.py", "print('baseline')\n")
     _write(root / "tests/test_runtime_gate.py", "print('baseline test')\n")
 
@@ -334,6 +355,7 @@ def test_release_sync_auto_drafts_unreleased_before_version_bump(self) -> None:
             self.assertIn("badge/version-2026--03--21.010203-orange.svg", (root / "README.md").read_text(encoding="utf-8"))
             self.assertIn("<!-- SOPIFY_VERSION: 2026-03-21.010203 -->", (root / "Codex/Skills/CN/AGENTS.md").read_text(encoding="utf-8"))
             self.assertIn("<!-- SOPIFY_VERSION: 2026-03-21.010203 -->", (root / "Claude/Skills/CN/CLAUDE.md").read_text(encoding="utf-8"))
+            self.assertIn("<!-- SOPIFY_VERSION: 2026-03-21.010203 -->", (root / "TraeCn/Skills/CN/user_rules/sopify.md").read_text(encoding="utf-8"))
 
     def test_release_draft_only_renders_non_empty_sections(self) -> None:
         with tempfile.TemporaryDirectory() as temp_dir: