CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

async-event-agent

构建异步/事件驱动 Agent,或让 Agent 响应外部事件(新邮件、webhook 回调、IM 消息、定时器、系统告警)、 处理工具执行期间的用户打断与多任务并发时使用。覆盖事件循环与安全点、三类事件触发工具、用户沟通与多渠道召回、 虚拟身份与隔离执行环境、队列式/取消式/并行式三种事件处理策略及紧急度判定,以及模型原生异步与同步接口兼容两条路线。 触发词:异步 Agent、事件驱动、event-driven、webhook、定时器、心跳、任务句柄、打断、steering、并行工具执行。

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, information-dense skill body with a clear when-to-use section, principles, practice patterns, pitfalls, and a validation-focused acceptance step. Main gaps: no executable code inside the bundle (all code lives in external chapter6 paths), a duplicate item number in the practice-patterns sequence, and no in-bundle reference files for progressive disclosure.

Suggestions

Include a minimal runnable snippet (e.g., a 10-line event-loop skeleton mirroring `runtime.py::AgentRuntime`) directly in SKILL.md so the core pattern is executable without leaving the bundle.

Fix the duplicate '6' numbering in 实践模式 (nine items are numbered 1-8) so the build sequence reads unambiguously.

Deduplicate the two 配套代码 entries for `chapter6/async-agent/` and add a brief in-bundle reference (or trim external paths) so referenced material is reachable from the skill itself.

DimensionReasoningScore

Conciseness

Dense, high-signal bullets with no filler or explanation of concepts Claude already knows (e.g., '取消 ≠ 撤销', '轮询冒充异步'). A few very long run-on bullets in 核心原则 and a redundant second description of `chapter6/async-agent/` in 配套代码 keep it at 'efficient; minor instances that could be trimmed' rather than the lean 5.

4 / 5

Actionability

Concrete design guidance throughout: named event types (`user.interrupt`, `tool.result`, `timer.trigger`), naming conventions (`initiate_phone_call` → `phone_call_connected` events), explicit markers ('[未处理事件 2/4]'), a five-rule sync-compat layer, and referenced functions (`runtime.py::AgentRuntime`, `_dispatcher`, `_handle_interrupt`). It stops short of anchor 5 because there is no copy-paste-ready code or command in the body — the executable material lives in `chapter6/` paths outside this bundle.

4 / 5

Workflow Clarity

实践模式 gives a clear build sequence (搭骨架 → 接事件源 → 分类器 → 兼容层 → ... → 验收三层) with explicit validation ('验收三层' plus '先跑离线 demo 验证运行时再上真实模型'). Not a 5 because the numbered list contains a numbering error (two items are both labeled '6', making 9 items read as 8) and some steps lack per-step checkpoints.

4 / 5

Progressive Disclosure

Well-organized sections with clearly signaled one-level-deep pointers in 配套代码 and 深度阅读 ('`chapter6/async-agent/agent_framework_design.md`(Flux 框架的运行时设计)'). Scored against the actual bundle: no references/, scripts/, or assets/ directories exist, so all referenced paths point outside the skill — a minor navigation gap that fits 'good structure; minor organization gaps' rather than the fully in-bundle 5.

4 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities, gives an explicit use-when clause, and supplies a rich bilingual trigger-term list. Only minor overlap risk with broader agent-building/scheduling skills prevents top marks on distinctiveness.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities: '构建异步/事件驱动 Agent', '响应外部事件(新邮件、webhook 回调、IM 消息、定时器、系统告警)', '处理工具执行期间的用户打断与多任务并发', and comprehensively enumerates coverage areas (event loop & safe points, three event-handling strategies, two native-async vs sync-compat routes, virtual identity, multi-channel recall). Matches the 'multiple specific concrete actions; comprehensive coverage' anchor; below it there is no anchor with equally complete coverage.

5 / 5

Completeness

Explicitly answers both questions: what ('构建异步/事件驱动 Agent...覆盖事件循环与安全点、三类事件触发工具...') and when ('...处理工具执行期间的用户打断与多任务并发时使用' plus a dedicated 触发词 line). Matches the top anchor with concrete trigger phrases; score 4 would require the 'when' clause to be less explicit.

5 / 5

Trigger Term Quality

The explicit trigger list covers natural terms with both Chinese and English synonyms: '异步 Agent、事件驱动、event-driven、webhook、定时器、心跳、任务句柄、打断、steering、并行工具执行'. This matches the 'comprehensive coverage including synonyms' anchor; a 4 would require notable missing natural terms, which is not the case.

5 / 5

Distinctiveness Conflict Risk

Clear niche (async/event-driven agent architecture) with distinct triggers like 'webhook、心跳、打断、steering、并行工具执行'. Minor overlap risk with general agent-orchestration or scheduling skills keeps it at the 'mostly distinct' anchor rather than the minimal-conflict 5.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bojieli/ai-agent-book

Path

skills/async-event-agent/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.