ability.md¶
ability.md 位于 abilities/<ability_id>/ability.md,用自然语言说明这个 Ability 的适用场景、Node 选择条件和编排顺序。Manager Agent 在选择 Ability 时参考这份说明。
建议包含:
- 这个 Ability 解决什么问题;
- 何时选择哪个 Node;
- Node 之间的顺序、依赖和失败处理;
- 不应使用该 Ability 的边界情况。
示例:
# Travel Guide Planning
1. `collect_info` 收集目的地、日期、人数、预算和偏好。
2. `generate_itinerary` 根据收集到的信息生成逐日行程,并检查预算与来源。
如果用户只问单个景点,不要进入该 Ability。
ability.md 与 ability.yaml 一起校验;删除 Node 时,管理命令会移除其中对该 Node id 的引用,但保留其他正文。