From harness-flow
Generates per-directory hierarchical AI agent context files (AGENTS.md, .cursor/rules/*.mdc, CLAUDE.md) for host projects vendoring HF. Scaffolds skeleton templates for root/mid/leaf directories; architect fills conventions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/harness-flow:hf-context-meshThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
宿主项目按目录层级生成 hierarchical AI agent 上下文文件的脚手架生成器。对应 OMO `/init-deep` 的等价能力,但跨三客户端:
宿主项目按目录层级生成 hierarchical AI agent 上下文文件的脚手架生成器。对应 OMO /init-deep 的等价能力,但跨三客户端:
AGENTS.md(被 directoryAgentsInjector hook 自动注入).cursor/rules/<name>.mdc(用 globs: <dir>/** 做目录级触发)CLAUDE.md(同目录约定文件名)按 ADR-008 D1 / ADR-010 D3 维持三客户端可移植性:本 skill 在三客户端各自给出独立模板,互不依赖。
HF 自身的 docs/principles/ 永不被本 skill 触碰(宪法层不变,按 docs/principles/soul.md 第 5 条)。
适用:
不适用:
docs/principles/ 不动(用 ADR / soul-doc 路径而非本 skill)docs/principles/soul.md 第 5 条docs/principles/(宪法层不变)--force);冲突时先 dry-run 列出会动哪些文件AGENTS.md / .mdc / CLAUDE.md 骨架文件docs/principles/| 方法 | 落地步骤 |
|---|---|
| Per-Client Template Set | references/agents-md-template.md 内 3 套独立模板 |
| 3-Layer Hierarchy (root / mid / leaf) | Workflow 步骤 1:识别 3 类目录 |
| Skeleton-Only Generation | Hard Gates "不替架构师写约定" |
| Architect-Driven Client Choice | Workflow 步骤 2:询问客户端 |
详细模板:references/agents-md-template.md。
扫描宿主项目目录树
询问架构师选定客户端
生成骨架文件
references/agents-md-template.md 的对应客户端 + 对应层级模板填充--force → dry-run 列出冲突后退出;否则继续架构师填充 Conventions / Patterns / Anti-Patterns
| 客户端 | 文件名 | 落点 |
|---|---|---|
| OpenCode | AGENTS.md | 每个识别的目录下 |
| Cursor | .cursor/rules/<dir-slug>.mdc | 项目根 .cursor/rules/ 下,按目录 slug 命名(globs 字段指向对应目录) |
| Claude Code | CLAUDE.md | 每个识别的目录下 |
不写 progress.md(本 skill 不在 SDD workflow 主链);不写 review record(不是 review 节点)。
docs/principles/--force)| 错误 | 问题 | 修复 |
|---|---|---|
| 把 leaf 模板用到 root | root 期望项目级总览,leaf 不够 | 按目录层级严格选模板 |
给 Cursor .mdc 写错 globs | rule 不会按目录触发 | globs 字段必须 <dir-from-project-root>/** |
| 同时为 3 客户端生成但只填 1 份 conventions | 3 客户端用户体验不一致 | 架构师为每客户端独立填或在每个文件里 reference 同一份共享文档 |
| 借口 | 反驳 / Hard rule |
|---|---|
| "架构师会嫌麻烦,我帮 ta 填几条 convention 当例子。" | Hard Gates: 不替架构师写约定;填例子 = 替 ta 决定标准,违反 soul.md 第 5 条 |
| "默认客户端按宿主目录有没有 .opencode/ 自动判断。" | Hard Gates: 客户端必须架构师拍板;目录自动识别 = 替 ta 做选择 |
| "已有的 AGENTS.md 内容看起来过时,顺手覆盖。" | Hard Gates: 不覆盖已有文件除非 --force;先 dry-run 列出冲突让架构师决定 |
| "HF 自己的 docs/principles 也是按目录的,顺便给它生成。" | Hard Gates: 永不触动 HF 自身 docs/principles/,按 soul.md 宪法层不变 |
| 文件 | 用途 |
|---|---|
references/agents-md-template.md | OpenCode / Cursor / Claude Code 三客户端各自的 root / mid / leaf 三层模板 |
--force)npx claudepluginhub hujianbest/harness-flow --plugin harness-flowGenerates hierarchical AGENTS.md structures for codebases to optimize AI agent token usage. Use for repo analysis, monorepos, JIT indexing, and token-efficient root/sub-folder docs.
Analyzes a project and generates a root AGENTS.md with operational commands, golden rules, and nested AGENTS.md files for high-context zones. Invoke via "AGENTS.md 만들어줘", "에이전트 규칙 만들어줘", or "/agents-md".
Creates minimal, high-signal CLAUDE.md and AGENTS.md context files for repos using empirical best practices. Triggers on /init, create/update requests, or missing context during brainstorming.