skill-catalog-builder · diff
git:20261008.c74aa9d to git:20261018.7f40741
11 added, 9 removed. Audit A to A.
---
name: skill-catalog-builder
description: Build a bounded Agent Skill catalog across explicit discovery scopes and report collisions before loading instruction bodies.
license: MIT
metadata:
lesson: "24"
---
- # Skill catalog builder
+ <a id="skill-catalog-builder"></a>
- Use this skill when an agent host needs deterministic discovery across more than one skill directory.
+ # 技能目录构建器
- 1. Read `references/discovery-contract.md`.
- 2. Review the example host policy in `assets/scope-policy.json`; do not assume its order is universal.
- 3. Run `python3 scripts/build_catalog.py project=PATH user=PATH` with scopes listed from highest to lowest precedence.
- 4. Inspect the JSON `collisions` and `omitted` arrays before activating a skill.
- 5. Load only the selected SKILL.md body. Load a direct reference only when that body names it.
+ 当智能体宿主需要跨多个技能目录进行确定性发现时，使用此技能。
- Never execute a bundled script during discovery. Never choose an equal-precedence duplicate by incidental filesystem order.
+ 1. 阅读 `references/discovery-contract.md`。
+ 2. 审查 `assets/scope-policy.json` 中的宿主策略示例；不要假设其中的顺序普遍适用。
+ 3. 运行 `python3 scripts/build_catalog.py project=PATH user=PATH`，按优先级从高到低列出范围。
+ 4. 激活技能前，检查 JSON 中的 `collisions` 和 `omitted` 数组。
+ 5. 仅加载所选 SKILL.md 的正文。只有正文明确引用时，才加载直接引用文件。
- Return the catalog budget, selected entries, collision resolutions, and omissions.
+ 发现阶段绝不执行包内脚本。绝不依靠偶然的文件系统顺序，从优先级相同的重复项中做选择。
+
+ 返回目录预算、选中条目、冲突解决结果和省略项。