技能医生
- 作者仓库星标 943
- 作者仓库 core
- 领域
- 文档
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @dotCMS · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Skill Doctor
Diagnose issues with repository skills, manage local overrides, and optimize skill quality.
**Scope:** Skills in the current repository's `.claude/skills/` directory only.
## Routing
Parse `$ARGUMENTS`:
| Pattern | Mode |
|---------|------|
| `list` | **list** (all repo skills) |
| `info <skill>` | **list** (detail for one skill) |
| `feedback [skill] "<message>"` | **feedback** (quick note) |
| (empty) or `<skill-name>` | **diagnose** |
| `--optimize <skill>` | **optimize** |
| `--manage [skill]` | **manage** (status) |
| `clone/diff/sync/revert <skill>` | **manage** (lifecycle) |
| `report/gist/pr <skill>` | **deliver** |
| `resolve <skill>` | **resolve** |
Unrecognized input: show this table and ask to rephrase. Then **read `./reference.md`** for detailed procedures.
## List
Dynamically discovers repo skills by reading `.claude/skills/*/SKILL.md`. Shows name, description, invocation, and override status. `info <skill>` reads the full SKILL.md to provide detailed usage guidance. All information comes from the skill files themselves — nothing is hardcoded. See reference.md for details.
## Feedback
Lightweight path for quick notes. No investigation or quality gate — just scrub, preview, confirm, post. If skill name is omitted, ask which skill (or use the most recently invoked skill if known from conversation context). See reference.md for details.
## Manage
Lifecycle: clone -> edit -> diff -> sync/revert -> pr/gist. Local overrides live at `~/.claude/skills/<name>/` with `.skill-origin.json` tracking.
## Diagnose
1. **Identify** skill, validate it exists
2. **Classify**: `invalid_command` | `wrong_assumption` | `stale_info` | `other`
3. **Investigate** -- reproduce, root cause, determine fix, check related issues. Quality gate: confirmed problem + root cause + suggested fix
4. **Duplicate check** in Discussion thread. Match found: upvote, add context, or report anyway
5. **Route**: local override -> fix inline, stop. Repo -> offer clone-and-fix or report-only
6. **Scrub** PII, **review** with developer, **deliver** to GitHub Discussion + Slack
## Optimize
Checks frontmatter, token efficiency (<500 words), structure quality, and staleness (file paths, commands, flags). Scored report with fixes. Local overrides fixed directly; repo versions cloned first.
## Deliver & Resolve
**Deliver**: GitHub Discussion (primary, one thread per skill) + Slack `#log-skill-feedback` (optional notification). Check prerequisites first (gh auth, repo access). See reference.md.
**Resolve**: After fix PR merges, mark Discussion reports resolved, post Slack summary, offer to lock thread.
## Common Mistakes
See reference.md for the full table. Key rules:
- Never send reports without root cause + suggested fix
- Always check Discussion thread for duplicates before reporting
- Always run `gh auth status` before any delivery action
- `revert` always shows diff and requires name confirmation
## Override Warning
When ANY skill is invoked and `~/.claude/skills/<name>/.skill-origin.json` exists, output before skill content:
```
SKILL OVERRIDE ACTIVE: <name>
Using: ~/.claude/skills/<name>/ (local)
Instead of: .claude/skills/<name>/ (repo)
Cloned from: <sha> | Repo is N commits ahead
Run /skill-doctor --manage <name> for options
``` 章节与文件索引
按说明文件中的顺序排列。
路由
列表
反馈意见
管理
诊断
文件/命令 -> .claude/skills/ · $ARGUMENTS · list · info <skill> · feedback [skill] "<message>" · <skill-name> · --optimize <skill> · --manage [skill]
内容校验值 -> f0345bc9f54d
当前原文的自动摘译,尚未人工审校。
路由
解析
$ARGUMENTS:模式·模式list·列表(所有存储库技能)info <skill>·列表(一项技能的详细信息)feedback [skill] "<message>"·反馈(快速注释)列表
通过阅读
.claude/skills/*/SKILL.md动态发现repo技能。显示名称、描述、调用和覆盖状态。info <skill>阅读完整的SKILL.md以提供详细的使用指导。所有信息都来自技能文件本身 - 没有任何内容是硬编码的。详细信息请参见参考.md。反馈意见
用于快速笔记的轻量级路径。无需调查或质量关卡——只需擦洗、预览、确认、发布。如果省略技能名称,请询问是哪个技能(或者如果从对话上下文中知道,则使用最近调用的技能)。详细信息请参见参考.md。
管理
生命周期:克隆 -> 编辑 -> diff -> 同步/恢复 -> pr/gist。本地覆盖位于
~/.claude/skills/<name>/并带有.skill-origin.json跟踪。诊断
识别技能,验证其存在分类:
invalid_command|wrong_assumption|stale_info|other调查——重现、根本原因、确定修复、检查相关问题。质量门:已确认的问题+根本原因+建议的修复讨论线程中的重复检查。找到匹配:投票、添加上下文或报告 路线:本地覆盖 -> 修复内联,停止。回购 -> 提供克隆和修复或仅报告