技能提高者

安全 社区

技能解读

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

激活合约

当需要审核、重构、标准化或改进现有的SKILL.md文件时,请使用此技能。当从可重用模式创建全新技能时,请使用skill-creator。

硬性规定

当docs/skill-style-guide.md存在时,将其视为规范样式合同。将SKILL.md视为真理来源;保留作者意图、关键规则、激活语义和输出要求。使用.atl/skill-registry.md作为技能名称、触发器、范围和确切路径的索引;不要期望生成摘要。默认为仅审核。仅当用户明确要求应用改进时才修改文件。

决策门

情况 · 行动 前言缺失或无效 · 修复name,引用单行 description、license 和 metadata 技能读起来像教程文档 · 转换为运行时指令并将背景移至 references/ 正文超出预算 · 保留规则,将示例/背景移至支持文件 隐藏在散文中的分支逻辑 · 转换为紧凑的决策表

执行步骤

阅读docs/skill-style-guide.md;如果不可用,则强制执行核心 LLM-first 结构:frontmatter、激活契约、硬规则、决策门、执行步骤、输出契约、参考文献。阅读.atl/skill-registry.md;使用列出的路径来选择技能。如果丢失,请扫描已知技能目录中的*/SKILL.md。对于每个选定的技能,审核元数据、触发清晰度、部分顺序、正文预算、可操作性、决策门、输出合同和本地参考。

产出合约

返回:审核的技能和使用的路径。发现的问题,按严重性分组。如果请求应用模式,文件已更改。当技能元数据或路径发生更改时,注册表刷新建议。

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

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

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

## Activation Contract

Use this skill when asked to audit, refactor, normalize, or improve existing `SKILL.md` files. Use `skill-creator` instead when creating a brand-new skill from a reusable pattern.

## Hard Rules

- Treat `docs/skill-style-guide.md` as the normative style contract when it exists.
- Treat `SKILL.md` as the source of truth; preserve author intent, critical rules, activation semantics, and output requirements.
- Use `.atl/skill-registry.md` as an index of skill names, triggers, scopes, and exact paths; do not expect generated summaries.
- Default to audit-only. Modify files only when the user explicitly asks to apply improvements.
- Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local `references/` or `assets/`.
- Do not invent triggers, policies, or domain rules. Mark ambiguous cases for human review.

## Decision Gates

| Situation | Action |
| --- | --- |
| Missing or invalid frontmatter | Fix `name`, quoted one-line `description`, `license`, and `metadata` |
| Skill reads like tutorial docs | Convert to runtime instructions and move background to `references/` |
| Body exceeds budget | Preserve rules, move examples/background to supporting files |
| Branching logic hidden in prose | Convert to a compact decision table |
| Rules conflict or intent is unclear | Report the issue; do not rewrite that rule automatically |

## Execution Steps

1. Read `docs/skill-style-guide.md`; if unavailable, enforce the core LLM-first structure: frontmatter, Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References.
2. Read `.atl/skill-registry.md`; use listed paths to select skills. If missing, scan known skill directories for `*/SKILL.md`.
3. For each selected skill, audit metadata, trigger clarity, section order, body budget, actionability, decision gates, output contract, and local references.
4. Return an audit report grouped by skill with severity and exact proposed changes.
5. In apply mode, edit only safe issues, preserve content, create supporting files when needed, then rerun or request `gentle-ai skill-registry refresh`.

## Output Contract

Return:
- Skills audited and paths used.
- Issues found, grouped by severity.
- Files changed, if apply mode was requested.
- Registry refresh recommendation when skill metadata or paths changed.
- Ambiguities that need human review.

## References

- `docs/skill-style-guide.md` — normative LLM-first skill style guide for this repo.

讨论

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