mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-04 06:37:44 +00:00
tradecatlabs
f1f0b9fe75
Move the complete research domain from docs/research to root-level research, update indexes and path-aware tooling, and align raw snapshot governance and CODEOWNERS.\n\nVerified with make test and GitHub CI.
54 lines
2.5 KiB
Markdown
54 lines
2.5 KiB
Markdown
# research/harness/ Agent 指南
|
|
|
|
## 目录职责
|
|
|
|
`research/harness/` 是 Harness 研究对象目录，维护 AI 生成系统中的工程控制、评估器、反馈闭环、上下文注入、架构约束和长期治理判断。
|
|
|
|
这里的文档回答：
|
|
|
|
- Harness 是什么。
|
|
- Harness 解决 AI 生成系统中的什么可靠性问题。
|
|
- 哪些机制属于 Harness，哪些只是普通工具调用或脚本封装。
|
|
- 哪些结论已经可采用，哪些仍处于观察或待验证状态。
|
|
- 成熟内容应迁移到 concepts、references、workflow 还是 skills。
|
|
|
|
## 文件地图
|
|
|
|
```text
|
|
harness/
|
|
├── README.md # 对象入口：导航、定位和阅读顺序
|
|
├── harness-engineering.md # 正文：Harness 工程解析
|
|
├── raw/ # raw 事实层：外部来源抓取、原始材料
|
|
│ ├── README.md
|
|
│ ├── AGENTS.md
|
|
│ └── lilian-weng-harness-engineering-for-self-improvement.md
|
|
├── notes/ # 研究摘记：中文提纲、短摘和待提炼线索
|
|
│ ├── README.md
|
|
│ ├── AGENTS.md
|
|
│ ├── lilian-weng-harness-rsi-outline.md
|
|
│ └── lilian-weng-harness-rsi-short-note.md
|
|
└── AGENTS.md # 本目录操作规则
|
|
```
|
|
|
|
## 对象边界
|
|
|
|
- 本目录只维护 Harness 作为研究对象的判断、证据、风险和采用建议。
|
|
- 不承载稳定操作手册；稳定流程迁移到 `docs/workflow/`。
|
|
- 不承载通用工程模板；稳定模板迁移到 `docs/references/`。
|
|
- 不承载可执行能力；可复用能力迁移到 `skills/`。
|
|
- 不把单个工具、单篇文章或单次实验直接包装成稳定结论。
|
|
|
|
## 证据要求
|
|
|
|
- 外部事实优先引用官方文档、原始仓库、论文或可信一手来源。
|
|
- AI 摘要不能作为事实源，只能作为待核验线索。
|
|
- 新增结论必须区分：事实、解释、采用判断、风险和待验证项。
|
|
- 涉及最新模型、工具、仓库状态或产品能力时，必须核验当前来源。
|
|
|
|
## 修改规则
|
|
|
|
- 新增 Harness 研究正文时，优先放入本目录，而不是散落在 `research/` 根目录。
|
|
- 新增、删除、移动或重命名本目录文档时，必须同步更新本目录 `README.md`、上级 `research/README.md`、根 `README.md`、必要的 `docs/README.md` 跨入口、`metadata/taxonomy.yml` 和必要的 `metadata/redirects.yml`。
|
|
- 面向 AI 引用的重要入口变化，必须同步更新 `llms.txt` 和 `assets/ai-citation/llms-full.txt`。
|
|
- 修改后运行 `make sync-doc-toc` 和 `make test`。
|