From 914eb3b26eb078dd36903930505e54cd6f60be25 Mon Sep 17 00:00:00 2001
From: gewuyou <95328647+GeWuYou@users.noreply.github.com>
Date: Sat, 18 Apr 2026 22:22:05 +0800
Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E6=96=B0=E5=A2=9E=20ai-libs=20?=
 =?UTF-8?q?=E5=8F=AA=E8=AF=BB=E5=8F=82=E8=80=83=E8=A7=84=E5=88=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 ai-libs 目录作为第三方源码只读参考区的仓库约束
- 更新第三方参考说明并要求在计划与 trace 中记录本地参考路径
- 排除 ai-libs 目录
---
 .gitignore | 1 +
 AGENTS.md  | 7 +++++++
 2 files changed, 8 insertions(+)

diff --git a/.gitignore b/.gitignore
index d6abff17..0f1b87a5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,5 +15,6 @@ opencode.json
 docs/.omc/
 docs/.vitepress/cache/
 local-plan/
+ai-libs/
 # tool
 .venv/
diff --git a/AGENTS.md b/AGENTS.md
index 9cf4ec07..100aa81d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -286,6 +286,13 @@ bash scripts/validate-csharp-naming.sh
 
 - Update the relevant `README.md` or `docs/` page when behavior, setup steps, architecture guidance, or user-facing
   examples change.
+- Treat `ai-libs/` as a read-only third-party source reference area.
+- Code under `ai-libs/**` exists for comparison, tracing, design study, and behavior verification; do not modify it
+  unless the user explicitly asks to sync or update that third-party snapshot.
+- When implementation plans, traces, reviews, or design notes say “reference a third-party project”, prefer the
+  repository-local path under `ai-libs/` instead of an unspecified upstream repository.
+- If a task depends on observations from `ai-libs/**`, record the referenced path and conclusion in the active plan or
+  trace rather than editing the third-party reference copy.
 - The main documentation site lives under `docs/`, with Chinese content under `docs/zh-CN/`.
 - Keep code samples, package names, and command examples aligned with the current repository state.
 - Prefer documenting behavior and design intent, not only API surface.