Skill 收录评估器

对候选资源进行证据驱动的核验。不要只根据仓库简介、搜索摘要或 Star 做决定。

工作流程

1. 规范化候选地址

• 接受 GitHub 仓库、仓库子目录、PR、Issue 或用户提供的项目名。
• 从 tree/、blob/ 等子路径提取 owner/repo，同时保留指向独立 Skill 的原始子路径。
• 在当前精选列表中搜索仓库名、规范化 URL 和旧名称，判断是新增、重复还是已有条目更新。
• 遇到仓库重命名或转移时，使用最终规范地址，避免继续收录重定向 URL。

rg -n "owner/repo|项目名" README.md

2. 获取仓库事实

优先使用已认证的 GitHub CLI 获取只读信息：

gh repo view owner/repo \
  --json nameWithOwner,description,stargazerCount,forkCount,isArchived,isPrivate,createdAt,pushedAt,licenseInfo,url

gh api repos/owner/repo/contents \
  --jq '.[] | [.type,.name,.path] | @tsv'

gh api repos/owner/repo/contents/README.md \
  -H 'Accept: application/vnd.github.raw+json'

若 gh 不可用，可使用公开网页或其他只读方式核验，但必须说明哪些事实未能确认。

3. 核验真实资产和安装路径

至少确认一项可复用资产真实存在：

• SKILL.md 或 skills/
• .claude-plugin/plugin.json、marketplace 或 plugin 安装命令
• agents/、commands/、hooks 或可迁移的 AGENTS.md
• MCP Server、CLI、SDK 或明确的 Agent workflow
• 针对 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw 等工具的安装说明

继续检查：

• README 是否说明前置条件、安装、配置和使用方式。
• 示例命令是否指向真实包名或路径。
• 仓库是否为空、仅有概念文案或只有营销页面。
• 子目录 Skill 是否可以独立安装；不能独立安装时优先收录仓库级地址。

4. 评估中文用户价值

从实际场景判断价值，而不是只看功能数量：

• 是否解决代码审查、测试、安全、文档、性能、DevOps、内容创作、办公自动化或知识管理等高频需求。
• 是否支持中文内容、国内平台、Windows 环境或中文团队常见工作流。
• 英文项目是否有足够清晰的安装路径，让中文用户无需二次研究即可使用。
• 与已收录项目相比，是否有新的场景、官方来源或明显更完整的实现。

建议分类只能从项目现有分类中选择：

• 明星技能
• 平台运营 / 自媒体 / 办公流量
• 开发效率
• 内容创作
• 学术科研
• AI Agent
• 金融 / 商业
• 中文专属

5. 检查风险和硬性淘汰条件

以下情况直接建议不收录：

• 404、私有、空仓库、明显模板或已归档且没有替代地址。
• 与 Agent Skills、Plugin、MCP 或 AI 编程工作流没有直接关系。
• 看不到实际资产、安装方式或可验证能力。
• 涉及盗号、恶意攻击、绕过付费、违法采集或明显侵权。
• 项目描述与仓库内容明显不符。

以下情况不一定淘汰，但必须显式提示：

• 强依赖商业 API、订阅、云端浏览器或第三方账号。
• 会自动发布内容、发送消息、操作交易或修改外部平台状态。
• 涉及爬虫、登录态、Cookie、Token、浏览器自动化或账号风控。
• 许可证不明确，或限制商业使用、再分发和修改。
• 刚创建、低 Star、长期未维护，或只由单个未经验证的服务支撑。

6. 评分并给出结论

使用 100 分制辅助判断，证据和硬性条件优先于总分：

维度	分值	判断重点
与 Agent 生态直接相关	25	明确支持的工具和工作流
可安装性	20	安装命令、前置条件、可复现性
真实资产	20	Skill、Plugin、Agent、MCP、CLI 等
文档完整度	15	README、示例、配置和边界
中文用户价值	10	高频场景、中文或国内生态适配
活跃度与可信度	10	更新、维护者、许可证、测试

按风险扣 0–30 分。默认解释区间：

• 75–100：建议收录
• 60–74：谨慎收录，需要补充边界或证据
• <60：暂不收录

不要因 Star 低而自动拒绝，也不要因 Star 高而跳过资产核验。

输出格式

## 候选资源核验报告

### 结论
- 建议：收录 / 谨慎收录 / 暂不收录 / 更新现有条目
- 推荐分类：分类名
- 总分：XX/100

### 核验事实
| 项目 | 证据 |
|------|------|
| 仓库状态 | 可访问、未归档、最近更新时间 |
| 实际资产 | 具体路径或文件 |
| 安装方式 | 已验证的命令或文档位置 |
| 支持工具 | Claude Code / Codex / ... |
| 重复检查 | README 中是否已有 |

### 风险与边界
- 前置条件、账号风险、商业依赖或许可证限制

### 中文收录文案
| [项目名](https://github.com/owner/repo) | 解决什么场景，支持哪些工具，对中文用户有什么价值（123⭐）|

### 核验说明
- 未确认的事实和需要维护者人工复核的部分

收录执行规则

• 用户只要求评估时，仅输出报告，不修改仓库或 GitHub 状态。
• 用户明确要求加入精选列表且候选通过核验时，先修改 README，再运行官网同步和项目检查。
• 描述使用自然中文，技术术语保留英文，不照抄英文仓库简介。
• Star 使用核验时的真实值；无法读取时省略并说明，不得猜测。
• “官方”“生产级”“最大”“首个”等词只有在证据充分时才使用。
• 高风险项目的收录文案必须写清依赖和适用边界，不能暗示无风险全自动运行。