技能登记处
- 作者仓库星标 3,249
- 许可证 MIT
- 作者仓库 gentle-ai
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @Gentleman-Programming · MIT
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
## Activation Contract
Use this skill after installing, removing, creating, moving, or renaming skills, or when a delegator needs a fresh skill index.
## Hard Rules
- The registry is an index, not a compiler or summary. `SKILL.md` remains the source of truth.
- Do not generate or inject compact rules by default; preserve author intent by passing exact skill paths to subagents.
- Always write `.atl/skill-registry.md` regardless of SDD persistence mode.
- Save the registry to Engram as `topic_key: skill-registry` when available, with `capture_prompt: false`.
- Skip `sdd-*`, `_shared`, and `skill-registry`; deduplicate by skill name, preferring project-level skills over user-level skills.
- Add `.atl/` to `.gitignore` when possible unless explicitly disabled.
## Decision Gates
| Situation | Action |
| --- | --- |
| Same skill exists globally and in project | Keep the project-level skill |
| Same skill exists in multiple global locations | Keep the first source in scan order |
| No skills found | Write an empty registry so agents stop searching blindly |
| Agent will delegate work | Select matching registry rows and pass their `SKILL.md` paths |
## Execution Steps
1. Scan all known user and project skill directories for `*/SKILL.md`.
2. Read frontmatter only as needed to extract `name` and `description` trigger text.
3. Render `.atl/skill-registry.md` with scanned sources, registry contract, skill name, trigger/description, scope, and exact path.
4. Persist to Engram when available using `title: skill-registry`, `topic_key: skill-registry`, `type: config`, and `capture_prompt: false`.
5. Return the registry path, skill count, cache status, and whether Engram was updated.
## Output Contract
Return:
- Project name and `.atl/skill-registry.md` path.
- Number of indexed skills.
- Whether the cache was hit or regenerated.
- Any skipped or duplicate skills when relevant.
## References
- `docs/skill-style-guide.md` — how skills should be authored before indexing.
- `skills/_shared/skill-resolver.md` — how delegators use the index.
章节与文件索引
按说明文件中的顺序排列。
硬性规定
决策门
执行步骤
产出合约
参考文献
文件/命令 -> .atl/skill-registry.md · topic_key: skill-registry · capture_prompt: false · sdd-* · _shared · skill-registry · .atl/ · .gitignore
内容校验值 -> eb60fef3f354
当前原文的自动摘译,尚未人工审校。
硬性规定
注册表是一个索引,而不是编译器或摘要。
SKILL.md仍然是真理的来源。默认情况下不生成或注入紧凑规则;通过将精确的技能路径传递给子代理来保留作者的意图。无论 SDD 持久模式如何,始终写入.atl/skill-registry.md。将注册表保存为 Engram 作为topic_key: skill-registry(如果可用),并使用capture_prompt: false。跳过sdd-*、_shared和skill-registry;按技能名称进行重复数据删除,优先选择项目级技能而不是用户级技能。决策门
情况 · 操作 全局和项目中存在相同的技能 · 保留项目级技能 多个全局位置存在相同的技能 · 按扫描顺序保留第一个源 未找到技能 · 编写一个空注册表,以便代理停止盲目搜索 代理将委派工作 · 选择匹配的注册表行并传递其
SKILL.md路径执行步骤
扫描所有已知的用户和项目技能目录中的
*/SKILL.md。仅根据需要读取 frontmatter 以提取name和description触发文本。使用扫描的源、注册表合同、技能名称、触发器/描述、范围和确切路径渲染.atl/skill-registry.md。当可用时,使用title: skill-registry、topic_key: skill-registry、type: config和capture_prompt: false坚持进行印迹。产出合约
返回:项目名称和
.atl/skill-registry.md路径。索引技能的数量。缓存是否被命中或重新生成。任何相关的跳过或重复的技能。参考文献
docs/skill-style-guide.md— 在索引之前应如何编写技能。skills/_shared/skill-resolver.md— 委托人如何使用索引。