From c98d65c1f1cba0a86a76319be630c666549db522 Mon Sep 17 00:00:00 2001
From: csh <caoshenghui@tinysoft.com.cn>
Date: Mon, 12 Jan 2026 16:03:31 +0800
Subject: [PATCH] :wrench: chore(sync): rewrite agents docs paths

---
 scripts/sync_standards.sh | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/scripts/sync_standards.sh b/scripts/sync_standards.sh
index 4889632..1060754 100644
--- a/scripts/sync_standards.sh
+++ b/scripts/sync_standards.sh
@@ -117,6 +117,27 @@ fi
 cp -R "$AGENTS_SRC" "$AGENTS_DST"
 echo "Synced .agents/$AGENTS_NS from standards."
 
+# Rewrite docs/* references to the snapshot docs path.
+REL_SNAPSHOT=""
+case "$SRC" in
+  "$ROOT"/*) REL_SNAPSHOT="${SRC#$ROOT/}" ;;
+esac
+if [ -n "$REL_SNAPSHOT" ]; then
+  DOCS_PREFIX="$REL_SNAPSHOT/docs"
+  for md in "$AGENTS_DST"/*.md; do
+    [ -f "$md" ] || continue
+    tmp="$(mktemp 2>/dev/null || echo "$AGENTS_DST/.rewrite.$(basename "$md").$timestamp")"
+    sed \
+      -e "s#\\\`docs/tsl/#\\\`$DOCS_PREFIX/tsl/#g" \
+      -e "s#\\\`docs/cpp/#\\\`$DOCS_PREFIX/cpp/#g" \
+      -e "s#\\\`docs/python/#\\\`$DOCS_PREFIX/python/#g" \
+      -e "s#\\\`docs/markdown/#\\\`$DOCS_PREFIX/markdown/#g" \
+      -e "s#\\\`docs/common/#\\\`$DOCS_PREFIX/common/#g" \
+      "$md" >"$tmp"
+    mv "$tmp" "$md"
+  done
+fi
+
 AGENTS_INDEX="$AGENTS_ROOT/index.md"
 if [ ! -f "$AGENTS_INDEX" ]; then
   cat >"$AGENTS_INDEX" <<'EOF'