技能登记处

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

硬性规定

注册表是一个索引,而不是编译器或摘要。 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 — 委托人如何使用索引。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Gentleman-Programming · MIT
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

## 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.

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。