技能
12 active · 3 mine · 2 stale · 1 plugin
全部12 系统8 我的3 插件1
⟢
trace-upstream-truth
已用 142 次
▣
run-checks
已用 88 次
⌗
add-gateway-event
已用 14 次
∮
add-dashboard-rest-endpoint
已用 22 次
★
simplify
已用 41 次
★
fewer-permission-prompts
已用 5 次
★
consolidate-memory
已用 3 次
⌥
init
已用 1 次
⊟
review
已用 12 次
⏚
security-review
已用 4 次
⌬
anthropic-skills:pdf
过期 · 待审
▭
claude-api
已禁用
启用 12 / 共 24 + 安装插件
capabilities / 技能 / trace-upstream-truth
追溯上游真相
对 Hermes 后端行为下定论之前 —— 请求结构、响应结构、事件负载、错误语义、认证流程 —— 先停下来 grep ref/hermes-agent/,不要靠猜。这个技能就是防止那种"过类型检查、运行时崩"的 schema 漂移 bug。
[ 01 ] 何时触发
当 Claude 即将对 Hermes 后端语义下定论 —— REST 请求结构、gateway 事件负载、认证流程、错误信封 —— 这个技能就自动触发。用户问"这个接口返回什么" / "为什么 PUT 要这样包"等也会触发。
⟢ 触发条件
· 对话上下文里检测到对后端的疑问
· 即将写读取
· user asks
· 即将写读取
/api/* 响应的代码· user asks
这个事件什么时候触发 / 为什么 PUT 要这样包[ 02 ] 它做什么
- grep
ref/hermes-agent/hermes_cli/web_server.py找路由模式。 - grep
tui_gateway/server.py找对应的事件名与 JSON-RPC 方法。 - 交叉对比上游 Web 应用
ref/hermes-agent/web/src/lib/,看官方客户端怎么用。 - 报告真实响应结构,附行号引用,然后再让你写依赖它的代码。
[ 03 ] SKILL.md
---
name: trace-upstream-truth
description: 通过阅读上游源码定位未文档化的 Hermes 后端行为,永不靠猜。
---
# 追溯上游真相
对 Hermes 后端行为下任何结论之前先用 —— 请求结构、响应结构、事件载荷、错误语义、认证流程。
本仓库的 UI 是上游 Dashboard ref/hermes-agent/ 的 瘦客户端。靠猜会产生过 pnpm typecheck 却在运行时崩的 schema 漂移 bug。
## 触发
用户说出以下任一:
· "这个接口返回什么"
· "这个事件什么时候触发"
· "为什么 PUT 要这样包"
…或 Claude 即将写一段依赖未文档化后端行为的代码。
## 流程
1. grep ref/hermes-agent/hermes_cli/web_server.py 找路由
2. grep tui_gateway/server.py 找事件
3. 交叉对比 ref/hermes-agent/web/src/lib/ 看官方用法
4. 带行号引用报告结构,然后再写依赖代码
[ 04 ] 近期调用
20260428_093142_oauth—— 读/api/web/health路由前触发 · 引用 4 行 · 0.4 s20260427_183004_session—— 加SessionTimelinereducer 前触发 · 引用 2 行 · 0.3 s20260427_111202_cron—— 假设 pause/resume 请求结构前触发 · 阻止 1 次 schema 漂移 · 0.6 s