技能介绍

问题：Agent 进仓库后没有「地图」

用 Harness 管理多轮 agent 协作时，常见情况是：仓库里还没有 CLAUDE.md、没有结构化的 docs/，.gitignore 也没挡住 agent 产生的临时文件。结果是每次对话都要重新扫目录，硬约束散落在聊天里，知识越写越乱。

本技能针对的是从零或半完成状态做初始化，而不是在已有完整 Harness 上微调链接（那应交给 harness-repo-map）。

它如何工作

遵循三条原则：最小可行骨架（少而准）、地图不是百科（CLAUDE.md 只做路由表）、先读后写（已有内容不盲目覆盖）。

典型流程：

项目侦察：用只读命令看目录、技术栈与现有文档；若已有 CLAUDE.md / docs/，先对比缺口。
与用户确认范围：部分结构已存在时，列出已有/缺失项，选择覆盖或增量补充。
生成三层结构：

- Map 层：CLAUDE.md（路由表 + 少量硬约束 + 工作流提示）
- Knowledge 层：docs/ 最小集（必选 ARCHITECTURE.md、QUALITY_SCORE.md；推荐 design-docs/index.md、exec-plans/ 等）
- Constraint 层：按技术栈追加 .gitignore 规则

按项目类型裁剪：单文件脚本、小型应用、Monorepo、多技术栈等，表格里定义该跳过哪些骨架，避免过度初始化。
自检清单：例如 CLAUDE.md 行数、docs/ 日期标注、路由是否指向具体文件路径等，未通过则修正后再输出创建/修改清单。

依赖上常与 harness-project-intake（初始化前分析）配合；完成后建议跑 harness-repo-map 校验文档结构。

适用边界与坑

不触发：已有完整 Harness 且未要求重做；只想了解方法论；项目极小不需要结构化知识；仅需重构文档而非全量初始化。
约束：Write 只用于新建 Harness 相关文件，不改业务代码、测试与既有配置。
常见坑：骨架文件堆太多、CLAUDE.md 塞满知识、docs/ 无「最后更新」日期、忽略 .gitignore、Monorepo 各子包重复造一套 docs/ 而非指向根目录共享文档。