name: 代理层审计 description: 审计代码库的代理层覆盖度并识别差距。用于评估代理层成熟度、识别投资机会或评估原语覆盖。 allowed-tools: Read, Grep, Glob

代理层审计技能

评估代码库的代理层成熟度并识别投资机会。

何时使用

评估当前代理层覆盖度
识别自动化差距
规划代理层投资
衡量向50%+代理时间进展

核心理念

“我是在处理代理层还是在处理应用层？”

此技能通过审计现有内容来帮助回答这个问题。

审计检查清单

1. 命令目录

检查 .claude/commands/ 或等效目录：

查找：
- chore.md      # 杂务规划模板
- bug.md        # 错误修复模板
- feature.md    # 功能规划模板
- implement.md  # 实施HOP
- test.md       # 测试执行模板
- review.md     # 审查模板

2. 规格目录

检查 specs/ 或等效目录：

查找：
- 基于问题的规格（issue-*.md）
- 生成的计划（chore-*.md, feature-*.md）
- 深度规格（复杂多文件架构）

3. ADW目录

检查 adws/ 或等效目录：

查找：
- adw_modules/agent.py  # 核心代理执行
- 网关脚本（adw_prompt.py, adw_slash_command.py）
- 组合工作流（adw_*_*.py）
- 触发器（trigger_*.py）

4. 钩子目录

检查 .claude/hooks/ 或等效目录：

查找：
- 预工具使用钩子
- 后工具使用钩子
- 用户提示提交钩子

5. 代理输出目录

检查 agents/ 或等效目录：

查找：
- ADW ID目录
- 状态文件（adw_state.json）
- 输出文件（cc_*.jsonl, cc_*.json）

6. 工作树支持

检查 trees/ 或等效目录：

查找：
- Git工作树设置
- 隔离配置
- 端口分配模式

覆盖度评分

组件	分数	存在？
.claude/commands/	20
specs/	15
adws/	25
adw_modules/agent.py	20
hooks/	10
agents/	5
trees/	5

总分：100分

分数	等级	建议
0-20	无	从最小可行层开始
21-40	基础	添加组合工作流
41-60	发展中	添加钩子和触发器
61-80	高级	添加工作树隔离
81-100	完整	关注优化

关键记忆参考

@agentic-layer-structure.md - 查找内容
@the-guiding-question.md - 为什么重要
@agentic-vs-application.md - 层分离

输出格式

## 代理层审计报告

**项目：** {名称}
**审计日期：** {日期}
**覆盖度分数：** {分数}/100

### 找到的组件
- [x] .claude/commands/ (5模板)
- [x] specs/ (12规格)
- [ ] adws/ (未找到)
- [ ] hooks/ (未找到)

### 成熟度等级
{等级} - {建议}

### 识别出的差距
1. 无ADW脚本用于工作流编排
2. 无钩子用于事件驱动自动化
3. 无工作树隔离用于并行化

### 推荐投资
1. 创建adws/adw_modules/agent.py
2. 添加网关脚本（adw_prompt.py）
3. 为常见任务创建组合工作流

### 时间投资分析
- 当前：~20%代理层
- 目标：50%+代理层
- 差距：需要30%更多投资于代理工作

要识别的反模式

命令存在但无规格（模板未使用）
规格存在但无ADW（手动执行）
许多一次性脚本而非组合工作流
应用层占主导（>70%代码库）

版本历史

v1.0.0 (2025-12-26): 初始发布

最后更新

日期： 2025-12-26 模型： claude-opus-4-5-20251101