| name | enhance-skill |
| description | 反馈 A2C-SMCP Marketplace Skill 的问题或改进建议。自动识别当前会话中使用的 Skill，提取优化点，收集版本信息，提交 GitHub Issue 到 a2c-smcp-skills 仓库。当使用某个 Skill 时发现步骤错误、分支遗漏、文档过时等问题时调用。 |
| argument-hint | [改进描述] |
Enhance Skill — Marketplace Skill 反馈
当使用 Marketplace Skill 过程中发现问题或有改进想法时，通过本 Skill 提交结构化反馈到 GitHub 仓库。
参数解析
/enhance-skill [改进描述]，改进描述可选，未提供时从会话上下文自动提取。
Step 1：识别目标 Skill
从当前会话上下文中识别用户正在使用（或刚使用完）的 Marketplace Skill：
- 搜索会话中最近调用的
/skill-name 或 /<plugin>:<skill> 命令
- 如果找到多个，用
AskUserQuestion 确认反馈针对哪一个
- 如果未找到，直接询问用户要反馈哪个 Skill
确定目标后，记录 Skill 名称。
Step 2：读取目标 Skill 源文件
从 marketplace 仓库中读取目标 Skill 的全部文件：
ls {marketplaceRoot}/skills/<skill-name>/
读取内容：
SKILL.md — 主流程resources/ 下所有文件 — 项目差异和补充指南
同时确定当前用户所在项目，找到对应的 resource 文件（如果有）。
Step 3：提取改进点
结合会话上下文和 Skill 源文件，分析以下维度：
| 维度 | 典型问题 |
|---|
| 步骤错误 | 命令不正确、路径已变更、API 已废弃 |
| 分支遗漏 | 某种场景/条件未覆盖 |
| 信息过时 | 版本/配置已变更 |
| 流程缺失 | 缺少必要步骤、顺序不合理 |
| Resource 缺失 | 某项目应有差异指南但未创建 |
| Resource 不准 | 项目 resource 中的信息与实际不符 |
| 体验改进 | 步骤可简化、可增加自动化 |
用 AskUserQuestion 向用户确认提取到的改进点。
Step 4：收集版本信息
Marketplace 版本：从本 Skill 的 base directory 路径中提取，无需 Bash。
插件缓存路径形如 ~/.claude/plugins/cache/<repo>/<plugin>/<hash>/skills/<skill-name>/，其中 <hash> 段即 Marketplace 版本（如 231b1476959b）。缓存目录不是 git 仓库，切勿对它执行 git log（会报 fatal: not a git repository）。
开发态从本地 git checkout 运行时，路径无 cache/.../<hash> 段——此时才用 git -C {marketplaceRoot} log --oneline -1 获取。
当前项目版本：
git log --oneline -1
Marketplace 版本从路径解析、不调用 Bash；项目版本的 git log 也不要与其它无关命令并行批量执行，避免一个调用失败连带取消同批次调用。
记录 Marketplace 版本 hash、当前项目名称和 commit hash。
Step 5：检查 gh CLI 可用性
gh auth status
如不可用，将格式化的 Issue 内容输出到会话中，供用户手动提交到 GitHub。
Step 6：格式化并提交 GitHub Issue
Issue 标题
格式：[<skill-name>] <简要描述>
Issue 内容
## 反馈类型
<步骤错误 / 分支遗漏 / 信息过时 / 流程缺失 / Resource 缺失 / Resource 不准 / 体验改进>
## 目标 Skill
- **Skill**: <skill-name>
- **文件**: <SKILL.md 和/或 resources/xxx.md>
- **Marketplace 版本**: <commit hash>
## 使用上下文
- **项目**: <当前项目名称>
- **项目版本**: <commit hash>
- **OS**: <macOS / Linux / Windows>
## 问题描述
<具体描述哪里有问题、在什么场景下触发>
## 建议改进
<具体的改进建议>
---
*由 enhance-skill 自动生成*
提交
gh issue create --repo A2C-SMCP/a2c-smcp-skills \
--title "<格式化标题>" \
--body "<格式化内容>" \
--label "enhancement"
提交成功后输出 Issue 链接。
注意事项
- 不自动修改 Skill 文件：本 Skill 仅提交反馈 Issue
- 敏感信息过滤：提交前检查，移除 IP、密码、Token 等
- 一次一个改进：多个改进点各创建独立 Issue
