# 飞轮技能监控知识飞轮的健康状况。 ## 飞轮模型会议 → 成绩单 → 锻造 → 池 → 推广 → 知识 ↑ │ └────────────────────────────────────────────────┘ 未来的会议会找到它 **速度** = 知识流过的速度 **摩擦** = 减缓飞轮速度的瓶颈 ## 执行步骤给定 `/flywheel`： ### 第 1 步：衡量知识库 # 计算顶级工件文件数（避免计算目录） LEARNINGS=$(find .agents/learnings -max深度 1 -type f 2>/dev/null | wc -l) PATTERNS=$(查找 .agents/patterns -max深度 1 -type f 2>/dev/null | wc -l) RESEARCH=$(查找 .agents/research -max深度 1 -type f 2>/dev/null | wc -l) RETROS=$(查找 .agents/retros -max深度 1 -type f 2>/dev/null | wc -l) echo“学习内容：$LEARNINGS” echo“模式：$PATTERNS” echo“研究：$RESEARCH” echo“复古：$RETROS” ### 第 2 步：检查最近的活动 # 最近的学习内容（过去 7 天）查找 .agents/learnings -maxdepth 1 -type f -mtime -7 2>/dev/null |厕所-l # 最近的研究查找 .agents/research -maxdepth 1 -type f -mtime -7 2>/dev/null |厕所-l ### 步骤 3：检测陈旧性 # 旧工件（> 30 天未修改）查找 .agents/ -name "*.md" -mtime +30 2>/dev/null |厕所-l ### 步骤 3.5：检查缓存健康状况 if 命令 -v ao &>/dev/null;那么 # 获取引用报告（缓存指标） CITE_REPORT=$(ao 指标 cite-report --json --days 30 2>/dev/null) 如果[-n“$CITE_REPORT”];那么 HIT_RATE=$(echo "$CITE_REPORT" | jq -r '.hit_rate // "未知"') UNCITED=$(echo "$CITE_REPORT" | jq -r '(.uncited_learnings // []) | length') STALE_90D=$(echo "$CITE_REPORT" | jq -r '.staleness["90d"] // 0') echo "缓存命中率：$HIT_RATE" echo“未引用的知识：$UNCITED” echo "陈旧（90d 未引用）：$STALE_90D" 菲否则 # 无 ao 回退：从文件计算近似指标 echo“缓存运行状况（无ao后备）：” # 过去 30 天内修改的学习内容（活动池） ACTIVE_30D=$(find .agents/learnings/ -name "*.md" -mtime -30 2>/dev/null | wc -l | tr -d ' ') echo“主动学习（30天）：$ACTIVE_30D” # 锻造等待晋升的候选人 FORGE_PENDING=$(ls .agents/forge/*.md 2>/dev/null | wc -l | tr -d ' ') echo "伪造候选者待定：$FORGE_PENDING" # 引文跟踪（如果 itations.jsonl 存在）如果 [ -f .agents/ao/itations.jsonl ];那么 CITATION_COUNT=$(wc -l < .agents/ao/itations.jsonl | tr -d ' ') UNIQUE_CITED=$(grep -o '"learning_file":"[^"]*"' .agents/ao/itations.jsonl 2>/dev/null | sort -u | wc -l | tr -d ' ') echo "总引用数：$CITATION_COUNT" echo“引用的独特学习内容：$UNIQUE_CITED” 否则 echo“没有引文数据（未找到引用.jsonl）” 菲 # 会话结果（如果结果.jsonl 存在）如果 [ -f .agents/ao/outcomes.jsonl ];那么 OUTCOME_COUNT=$(wc -l < .agents/ao/outcomes.jsonl | tr -d ' ') echo“记录的会话结果：$OUTCOME_COUNT” 菲菲 ### 步骤 4：检查 ao CLI 状态 if 命令 -v ao &>/dev/null;那么 ao 指标飞轮状态 2>/dev/null || echo“ao 指标飞轮状态不可用” ao 状态 2>/dev/null || echo "ao 状态不可用" ao 成熟度 --scan 2>/dev/null || echo "ao 成熟度不可用" ao 促进反模式 --dry-run 2>/dev/null || echo“ao 促进反模式不可用” ao 徽章 2>/dev/null || echo“ao 徽章不可用” # 知识维护 ao dedup --merge 2>/dev/null ||真实 ao 矛盾 2>/dev/null ||真实 ao 约束审查 2>/dev/null ||真实 ao 管理状态 2>/dev/null ||真实 ao 指标健康状况 2>/dev/null ||真实 ao 指标 cite-report --days 30 2>/dev/null ||真实 # 主动修剪：存档陈旧，驱逐低效用 ao 成熟度 --expire --archive 2>/dev/null ||真实 ao 成熟度 --evict --archive 2>/dev/null ||真实否则 echo“ao CLI 不可用 - 使用基于文件的指标” # 池库存 echo "泳池深度：" 学习模式池锻造知识研究回顾；做 COUNT=$(ls .agents/${pool}/*.md 2>/dev/null | wc -l | tr -d ' ') 回显“$池：$COUNT” 完成 # 全局模式 GLOBAL_COUNT=$(ls ~/.claude/patterns/*.md 2>/dev/null | wc -l | tr -d ' ') echo“全局模式：$GLOBAL_COUNT” # 检查是否有可升级的学习内容（请参阅references/promotion-tiers.md） echo“请参阅：skills/flywheel/references/promotion-tiers.md 了解层级定义” 菲 ### 步骤 4.5：流程指标（来自技能遥测）如果“.agents/ao/skill-telemetry.jsonl”存在，则使用“jq”提取：按技能的调用、每个技能的平均周期时间、门故障率。包含在“## Process Metrics”下的运行状况报告（步骤 6）中。 ### 步骤 5：验证工件一致性交叉引用验证：扫描知识工件以查找损坏的内部引用。使用“scripts/artifact-consistency.sh”（方法记录在“references/artifact-consistency.md”中）。默认允许列表位于“references/artifact-consistency-allowlist.txt”；使用“--no-allowlist”进行完整的原始审核。健康指标：>90% = 健康，70-90% = 警告，<70% = 严重。 ### 第 6 步：撰写健康报告 **写入：** `.agents/flywheel-status.md` #飞轮健康知识 **日期：** YYYY-MM-DD ## 泳池深度 |泳池|计数 |最近 (7 天) | |------|--------|-------------| |经验教训| <计数> | <计数> | |图案| <计数> | <计数> | |研究| <计数> | <计数> | |复古 | <计数> | <计数> | ## 速度（过去 7 天） - 提取会话： - 新的学习内容： - 新模式：<计数> ## 工件一致性 - 扫描的参考文献： - 损坏的参考文献： - 一致性得分：<百分比>% - 状态：<健康/警告/严重> ## 缓存健康状况 - 命中率：<百分比>% - 未引用的学习内容： - 陈旧（90 天未提及）： - 状态：<健康/警告/严重> ## 健康状况 <健康/警告/严重> ## 摩擦点 - <问题1> - <问题2> ## 建议 1.<推荐> 2.<推荐> ### 步骤 7：向用户报告告诉用户： 1.飞轮整体健康状况 2. 知识库深度 3. 近期活动 4. 任何摩擦点 5. 建议 ## 健康指标公制|健康 |警告|关键 ---|---|---|--- 学习/周 | 3+ | 1-2 | 1-2 0 陈旧的文物 | <20% | 20-50% | >50% 研究/计划比率| >0.5 | 0.2-0.5| <0.2 缓存命中率| >80% | 50-80% | <50% ## 缓存驱逐阅读“references/cache-eviction.md”以了解完整的驱逐流程（被动跟踪→置信度衰减→成熟度扫描→存档）。 ## 关键规则 * **定期监控** \- 飞轮需要注意 * **解决摩擦** \- 瓶颈缓慢复合 * **为飞轮提供动力** \- 运行 /retro 和 /post-mortem * **修剪过时的知识** \- 归档旧工件 ## 示例 **用户说：** `/flywheel` — 计算池深度，检查最近的活动，验证工件一致性，将运行状况报告写入 `.agents/flywheel-status.md`。 **挂钩触发器：** `/post-mortem` 之后 — 比较当前指标与历史指标，标记速度下降和摩擦点。 ## 故障排除问题 |原因 |解决方案 ---|---|--- 所有池计数为零 | `.agents/` 目录缺失或为空 |运行“/post-mortem”或“/retro”来播种知识池速度始终为零 |最近没有提取过数据（过去 7 天）|运行“/retro”或“/post-mortem”来提取和索引学习内容 “ao CLI 不可用”| ao 命令未安装或不在 PATH 中 |安装 ao CLI 或使用手动池计数回退过时的工件 >50% |自上次会话或非活动存储库以来已有很长时间 |运行“/provenance --stale”来审核和归档旧工件 ## 参考文档 * [references/artifact-consistency.md]() * [references/promotion-tiers.md]()

飞轮

包含技能