mcpField
I
intent-layer

intent-layer

github.com/crafter-stationAgent 工作流113629 次安装8 周前更新
代码仓库

关于 intent-layer

Intent Layer 是用于组织分层 AGENTS.md 文件的技能，让编码 Agent 按聚焦的上下文浏览代码库。它提供脚本检查配置状态、识别结构边界并估算目录复杂度。

主要功能

  1. 01检测现有上下文文件状态
  2. 02分析代码语义边界
  3. 03估算目录 Token 复杂度
  4. 04提供根级和子级文件模板
  5. 05引导记录职责与不变量

适用场景

  1. 01为代码库配置 AGENTS.md 上下文
  2. 02为复杂子系统添加指引
  3. 03记录不变量和反复出现的工程问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crafter-station/skills --skill intent-layer

安装后在 Claude Code 中输入/intent-layer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
capture-protocol.md
node-examples.md
templates.md
scripts/
analyze_structure.sh
detect_state.sh
estimate_tokens.sh

详细介绍

意图层

分层的 AGENTS.md 基础架构，让 Agent 像资深工程师一样浏览代码库。

核心原则

只能有一个根上下文文件。 项目根目录中不应同时存在 CLAUDE.md 和 AGENTS.md。对于复杂子系统，建议在子目录中创建子级 AGENTS.md。

工作流

1. Detect state
   scripts/detect_state.sh /path/to/project
   → Returns: none | partial | complete

2. Route
   none/partial → Initial setup (steps 3-5)
   complete     → Maintenance (step 6)

3. Measure [gate - show table first]
   scripts/analyze_structure.sh /path/to/project
   scripts/estimate_tokens.sh /path/to/each/source/dir

4. Decide
   No root file  → Ask: CLAUDE.md or AGENTS.md?
   Has root file → Add Intent Layer section + child nodes if needed

5. Execute
   Use references/templates.md for structure
   Use references/node-examples.md for real-world patterns
   Validate: one root, READ-FIRST directive, <4k tokens per node

6. Maintenance mode (when state=complete)
   Ask user:
   a) Audit nodes     → Use references/capture-protocol.md for SME questions
   b) Find candidates → Re-measure tokens, suggest new nodes
   c) Both

何时创建子级节点

信号操作
目录中的内容超过 20k 个 token创建 AGENTS.md
职责发生变化创建 AGENTS.md
隐式契约或不变量在最近的祖先目录中记录
横切关注点放在 LCA

请勿为以下情况创建：每个目录、简单工具、测试文件夹（除非复杂）。

记录问题

记录现有代码时，请询问：

  1. 该区域负责什么？哪些内容不在其职责范围内？
  2. 哪些不变量绝不能违反？
  3. 哪些问题会反复让新工程师感到困惑？
  4. 应始终遵循哪些模式？

资源

脚本：

  • scripts/detect_state.sh - 检查意图层状态（无／部分／完整）
  • scripts/analyze_structure.sh - 查找语义边界
  • scripts/estimate_tokens.sh - 衡量目录复杂度

参考资料：

  • references/templates.md - 根节点和子节点模板
  • references/node-examples.md - 实际示例
  • references/capture-protocol.md - SME 访谈流程

评论

支持 Markdown