docs(agents): 新增 ai-libs 只读参考规则

- 新增 ai-libs 目录作为第三方源码只读参考区的仓库约束
- 更新第三方参考说明并要求在计划与 trace 中记录本地参考路径
- 排除 ai-libs 目录
This commit is contained in:
gewuyou 2026-04-18 22:22:05 +08:00 committed by GeWuYou
parent c0ef3b5c00
commit 914eb3b26e
2 changed files with 8 additions and 0 deletions

1
.gitignore vendored
View File

@ -15,5 +15,6 @@ opencode.json
docs/.omc/
docs/.vitepress/cache/
local-plan/
ai-libs/
# tool
.venv/

View File

@ -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.