diff --git a/.gitea/ci/sync_tsl_playbook.sh b/.gitea/ci/sync_tsl_playbook.sh
new file mode 100644
index 00000000..4e5286e0
--- /dev/null
+++ b/.gitea/ci/sync_tsl_playbook.sh
@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Build the minimal TSL playbook bundle and publish its *expanded* contents to
+# the tsl-playbook branch. The branch tree mirrors the bundle root directly
+# (AGENTS.md, docs/, skills/) — there is no wrapping tsl-playbook/ directory.
+
+REPO_DIR="${REPO_DIR:-$(pwd)}"
+TARGET_BRANCH="${TARGET_BRANCH:-tsl-playbook}"
+BUILD_SCRIPT="${BUILD_SCRIPT:-scripts/build_tsl_playbook.py}"
+COMMIT_AUTHOR_NAME="${COMMIT_AUTHOR_NAME:-ci[bot]}"
+COMMIT_AUTHOR_EMAIL="${COMMIT_AUTHOR_EMAIL:-ci-bot@local}"
+
+cd "$REPO_DIR"
+
+git config user.name "$COMMIT_AUTHOR_NAME"
+git config user.email "$COMMIT_AUTHOR_EMAIL"
+
+source_sha="$(git rev-parse HEAD)"
+source_short="$(git rev-parse --short HEAD)"
+
+# Build the bundle into a temp dir *outside* the repo so that resetting the
+# target branch's working tree can never clobber the freshly built artifact.
+build_dir="$(mktemp -d)"
+cleanup() {
+  rm -rf "$build_dir"
+}
+trap cleanup EXIT
+
+bundle="$build_dir/tsl-playbook"
+python3 "$BUILD_SCRIPT" --output "$bundle"
+
+# Check out (or create) the target branch. It is a content-only branch that
+# shares no history with main, so an orphan branch keeps it clean.
+if git show-ref --verify --quiet "refs/remotes/origin/$TARGET_BRANCH"; then
+  git fetch origin "$TARGET_BRANCH"
+  git checkout -B "$TARGET_BRANCH" "origin/$TARGET_BRANCH"
+else
+  git checkout --orphan "$TARGET_BRANCH"
+fi
+
+# Replace the entire tracked tree with the bundle contents. `git rm` clears
+# tracked files; then copy the expanded bundle to the repo root.
+git rm -rf --quiet . >/dev/null 2>&1 || true
+
+# Copy bundle contents (including dotfiles) to the repo root.
+cp -R "$bundle"/. "$REPO_DIR"/
+
+git add -A
+
+if git diff --cached --quiet; then
+  echo "No tsl-playbook changes to publish."
+  exit 0
+fi
+
+git commit -m ":package: deps(tsl): sync tsl-playbook from ${source_short}
+
+Source-Commit: ${source_sha}"
+
+TOKEN="${WORKFLOW:-}"
+if [ -n "$TOKEN" ] && [ -n "${GITHUB_SERVER_URL:-}" ] && [ -n "${GITHUB_REPOSITORY:-}" ]; then
+  git remote set-url origin "https://oauth2:${TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY}.git"
+fi
+
+git push origin "$TARGET_BRANCH"
+echo "✅ Published tsl-playbook @ ${source_short}"
diff --git a/.gitea/workflows/sync-tsl-playbook.yml b/.gitea/workflows/sync-tsl-playbook.yml
new file mode 100644
index 00000000..54e179d3
--- /dev/null
+++ b/.gitea/workflows/sync-tsl-playbook.yml
@@ -0,0 +1,68 @@
+name: 📦 Sync TSL Playbook
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: sync-tsl-playbook-${{ github.repository }}
+  cancel-in-progress: true
+
+env:
+  WORKSPACE_DIR: "/home/workspace"
+  TARGET_BRANCH: "tsl-playbook"
+
+jobs:
+  sync:
+    name: 📦 Build and publish tsl-playbook
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: 📥 准备仓库
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          echo "========================================"
+          echo "📦 准备仓库到 WORKSPACE_DIR"
+          echo "========================================"
+
+          REPO_NAME="${{ github.event.repository.name }}"
+          TOKEN="${{ secrets.WORKFLOW }}"
+          mkdir -p "$WORKSPACE_DIR"
+          REPO_DIR="$(mktemp -d "$WORKSPACE_DIR/${REPO_NAME}.XXXXXX")"
+          if [ -n "$TOKEN" ]; then
+            REPO_URL="https://oauth2:${TOKEN}@${GITHUB_SERVER_URL#https://}/${GITHUB_REPOSITORY}.git"
+          else
+            REPO_URL="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git"
+          fi
+
+          git clone "$REPO_URL" "$REPO_DIR"
+
+          git -C "$REPO_DIR" fetch origin main
+          git -C "$REPO_DIR" checkout -B main origin/main
+
+          git config --global --add safe.directory "$REPO_DIR"
+          echo "REPO_DIR=$REPO_DIR" >> "$GITHUB_ENV"
+          echo "✅ 仓库准备完成"
+
+      - name: 📦 Build and publish tsl-playbook
+        shell: bash
+        env:
+          WORKFLOW: ${{ secrets.WORKFLOW }}
+        run: |
+          set -euo pipefail
+          cd "$REPO_DIR"
+
+          echo "========================================"
+          echo "🔨 Build bundle and sync $TARGET_BRANCH"
+          echo "========================================"
+
+          TARGET_BRANCH="$TARGET_BRANCH" bash .gitea/ci/sync_tsl_playbook.sh
+
+      - name: 🧹 清理临时仓库
+        if: always()
+        run: |
+          rm -rf "$REPO_DIR"
diff --git a/scripts/build_tsl_playbook.py b/scripts/build_tsl_playbook.py
new file mode 100644
index 00000000..78d78dd6
--- /dev/null
+++ b/scripts/build_tsl_playbook.py
@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""Build the minimal TSL playbook bundle."""
+import argparse
+import shutil
+import sys
+from pathlib import Path
+
+
+DEFAULT_OUTPUT = Path("tmp") / "tsl-playbook"
+API_REFERENCE_BULLET = (
+    "- 查 API / 函数的名字、参数、返回值和示例时，使用 "
+    "`tsl-api-reference` skill；已知名走 `--name`，未知名走 `--kw`。"
+)
+
+
+def copy_tree(src: Path, dst: Path) -> None:
+    shutil.copytree(src, dst)
+
+
+def build_agents_text(ruleset_path: Path) -> str:
+    text = ruleset_path.read_text(encoding="utf-8")
+    text = text.replace("# TSL 智能体规则", "# TSL Agent Instructions", 1)
+    if API_REFERENCE_BULLET not in text:
+        marker = (
+            "- 需要任何 TSL 语法、文件模型、函数、模块或金融数据事实时，"
+            "第一跳统一进 `docs/tsl/index.md`，由它路由到具体页；"
+            "不在本文件内猜文件路径，也不全目录搜索。"
+        )
+        text = text.replace(marker, f"{marker}\n{API_REFERENCE_BULLET}", 1)
+    return text.rstrip("\n") + "\n"
+
+
+def ensure_sources(repo_root: Path) -> tuple[Path, Path, Path]:
+    docs_tsl = repo_root / "docs" / "tsl"
+    skill = repo_root / "skills" / "tsl-api-reference"
+    ruleset = repo_root / "rulesets" / "tsl" / "index.md"
+    missing = [str(path) for path in (docs_tsl, skill, ruleset) if not path.exists()]
+    if missing:
+        raise FileNotFoundError("missing source path(s): " + ", ".join(missing))
+    return docs_tsl, skill, ruleset
+
+
+def clean_output(output: Path, repo_root: Path) -> None:
+    resolved = output.resolve()
+    forbidden = {
+        repo_root.resolve(),
+        (repo_root / "docs").resolve(),
+        (repo_root / "skills").resolve(),
+        (repo_root / "rulesets").resolve(),
+    }
+    if resolved in forbidden:
+        raise ValueError(f"refusing to replace source directory: {output}")
+    if output.exists():
+        shutil.rmtree(output)
+    output.mkdir(parents=True)
+
+
+def build(output: Path, repo_root: Path) -> None:
+    docs_tsl, skill, ruleset = ensure_sources(repo_root)
+    clean_output(output, repo_root)
+
+    (output / "AGENTS.md").write_text(
+        build_agents_text(ruleset), encoding="utf-8", newline="\n"
+    )
+    copy_tree(docs_tsl, output / "docs" / "tsl")
+    copy_tree(skill, output / "skills" / "tsl-api-reference")
+
+
+def main(argv=None) -> int:
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8")
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--output",
+        default=str(DEFAULT_OUTPUT),
+        help=f"output directory (default: {DEFAULT_OUTPUT.as_posix()})",
+    )
+    args = parser.parse_args(argv)
+
+    repo_root = Path(__file__).resolve().parents[1]
+    output = Path(args.output)
+    if not output.is_absolute():
+        output = repo_root / output
+
+    try:
+        build(output, repo_root)
+    except (FileNotFoundError, ValueError, OSError) as exc:
+        print(f"ERROR: {exc}", file=sys.stderr)
+        return 1
+
+    print(f"wrote {output}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
diff --git a/test/test_build_tsl_playbook.py b/test/test_build_tsl_playbook.py
new file mode 100644
index 00000000..a3944cec
--- /dev/null
+++ b/test/test_build_tsl_playbook.py
@@ -0,0 +1,67 @@
+import subprocess
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SCRIPT = ROOT / "scripts" / "build_tsl_playbook.py"
+
+
+class BuildTslPlaybookTests(unittest.TestCase):
+    def test_builds_minimal_tsl_playbook_tree(self):
+        with tempfile.TemporaryDirectory() as tmp_dir:
+            output = Path(tmp_dir) / "tsl-playbook"
+
+            result = subprocess.run(
+                [sys.executable, str(SCRIPT), "--output", str(output)],
+                capture_output=True,
+                text=True,
+            )
+
+            self.assertEqual(result.returncode, 0, msg=result.stderr)
+            self.assertEqual(
+                sorted(path.name for path in output.iterdir()),
+                ["AGENTS.md", "docs", "skills"],
+            )
+            self.assertFalse((output / "playbook.toml").exists())
+            self.assertFalse((output / ".agents").exists())
+            self.assertFalse((output / "docs" / "index.md").exists())
+
+            self.assertTrue((output / "docs" / "tsl" / "index.md").is_file())
+            self.assertTrue(
+                (output / "skills" / "tsl-api-reference" / "SKILL.md").is_file()
+            )
+            self.assertTrue(
+                (
+                    output
+                    / "skills"
+                    / "tsl-api-reference"
+                    / "scripts"
+                    / "lookup.py"
+                ).is_file()
+            )
+
+            agents_text = (output / "AGENTS.md").read_text(encoding="utf-8")
+            self.assertIn("# TSL Agent Instructions", agents_text)
+            self.assertIn("docs/tsl/index.md", agents_text)
+            self.assertIn("tsl-api-reference", agents_text)
+            self.assertNotIn(".agents/index.md", agents_text)
+            self.assertNotIn(".agents/tsl/index.md", agents_text)
+
+            source_docs = count_files(ROOT / "docs" / "tsl")
+            output_docs = count_files(output / "docs" / "tsl")
+            self.assertEqual(output_docs, source_docs)
+
+            source_skill = count_files(ROOT / "skills" / "tsl-api-reference")
+            output_skill = count_files(output / "skills" / "tsl-api-reference")
+            self.assertEqual(output_skill, source_skill)
+
+
+def count_files(path: Path) -> int:
+    return sum(1 for item in path.rglob("*") if item.is_file())
+
+
+if __name__ == "__main__":
+    unittest.main()