Files
tradecatlabs a8099f52fe docs: add research domains and resource registry
- add local external resources registry
- add research domain contract and per-repository research domains
- add raw fact snapshot governance and validation scripts

Validation:
- make test
- git diff --check HEAD~1..HEAD

Note:
- welcome workflow failed because its action input names are stale; core content CI passed.
2026-07-03 08:20:22 +08:00

27 lines
1.4 KiB
Markdown

# assets/ 目录 Agent 指南
本目录只维护静态资产与外部资源入口,包含:
- `assets/README.md`:静态资产与外部资源入口
- `assets/external-resources/`:本地外部资源注册表
- `assets/images/`:文档图片、截图、封面等图片资产
- `assets/templates/`:可复用模板附件
- `assets/datasets/`:示例数据、轻量数据集或数据说明
- `assets/ai-citation/`:面向 AI 助手、AI 搜索与 GEO/SEO 引用的语料资产
其中“外部资源”类入口文档的典型形态包括:
- 本地资源注册表(资源库、索引表、分类清单)
- 在线表格(资源库、索引表、清单)
- 远程文档(规范、课程、外部知识库)
- 其它需要在仓库内保留“可追溯入口”的外部资源
## 约束
- 不在此目录存放敏感信息(Token、私钥、个人隐私)。
- 不把知识库、Skills、提示词库、工具源码或第三方仓库重新塞回 `assets/`
- `tools/external/` 下的第三方镜像/子模块:除非任务明确要求,否则不要做“顺手改动/格式化/批量替换”。
- 尽量只存“入口文档与说明”,不要复制粘贴大段第三方内容。
- 外部资产必须写清:用途、维护者、更新方式、与仓库内文档的关系(谁是唯一真相源)。
- 外部资源注册表变更后运行 `make check-external-resources`