mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-09 09:07:46 +00:00

Files

T

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

2.1 KiB

Raw Blame History

docs/research/harness/ Agent 指南

目录职责

docs/research/harness/ 是 Harness 研究对象目录，维护 AI 生成系统中的工程控制、评估器、反馈闭环、上下文注入、架构约束和长期治理判断。

这里的文档回答：

Harness 是什么。
Harness 解决 AI 生成系统中的什么可靠性问题。
哪些机制属于 Harness，哪些只是普通工具调用或脚本封装。
哪些结论已经可采用，哪些仍处于观察或待验证状态。
成熟内容应迁移到 concepts、references、workflow 还是 skills。

文件地图

harness/
├── README.md                # 对象入口：导航、定位和阅读顺序
├── harness-engineering.md   # 正文：Harness 工程解析
└── AGENTS.md                # 本目录操作规则

对象边界

本目录只维护 Harness 作为研究对象的判断、证据、风险和采用建议。
不承载稳定操作手册；稳定流程迁移到 docs/workflow/。
不承载通用工程模板；稳定模板迁移到 docs/references/。
不承载可执行能力；可复用能力迁移到 skills/。
不把单个工具、单篇文章或单次实验直接包装成稳定结论。

证据要求

外部事实优先引用官方文档、原始仓库、论文或可信一手来源。
AI 摘要不能作为事实源，只能作为待核验线索。
新增结论必须区分：事实、解释、采用判断、风险和待验证项。
涉及最新模型、工具、仓库状态或产品能力时，必须核验当前来源。

修改规则

新增 Harness 研究正文时，优先放入本目录，而不是散落在 docs/research/ 根目录。
新增、删除、移动或重命名本目录文档时，必须同步更新本目录 README.md、上级 docs/research/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。

2.1 KiB Raw Blame History