--- name: skill-curator description: 中文 Skill 收录评估器。用于核验 GitHub 上的 Claude Code、Codex、Agent Skills、Plugin、MCP、CLI 或 Agent 工作流是否值得加入精选列表;检查真实资产、安装方式、活跃度、重复项和安全边界,并生成分类、中文描述与可追溯证据。 --- # Skill 收录评估器 对候选资源进行证据驱动的核验。不要只根据仓库简介、搜索摘要或 Star 做决定。 ## 工作流程 ### 1. 规范化候选地址 - 接受 GitHub 仓库、仓库子目录、PR、Issue 或用户提供的项目名。 - 从 `tree/`、`blob/` 等子路径提取 `owner/repo`,同时保留指向独立 Skill 的原始子路径。 - 在当前精选列表中搜索仓库名、规范化 URL 和旧名称,判断是新增、重复还是已有条目更新。 - 遇到仓库重命名或转移时,使用最终规范地址,避免继续收录重定向 URL。 ```bash rg -n "owner/repo|项目名" README.md ``` ### 2. 获取仓库事实 优先使用已认证的 GitHub CLI 获取只读信息: ```bash 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 高而跳过资产核验。 ## 输出格式 ```markdown ## 候选资源核验报告 ### 结论 - 建议:收录 / 谨慎收录 / 暂不收录 / 更新现有条目 - 推荐分类:分类名 - 总分:XX/100 ### 核验事实 | 项目 | 证据 | |------|------| | 仓库状态 | 可访问、未归档、最近更新时间 | | 实际资产 | 具体路径或文件 | | 安装方式 | 已验证的命令或文档位置 | | 支持工具 | Claude Code / Codex / ... | | 重复检查 | README 中是否已有 | ### 风险与边界 - 前置条件、账号风险、商业依赖或许可证限制 ### 中文收录文案 | [项目名](https://github.com/owner/repo) | 解决什么场景,支持哪些工具,对中文用户有什么价值(123⭐)| ### 核验说明 - 未确认的事实和需要维护者人工复核的部分 ``` ## 收录执行规则 - 用户只要求评估时,仅输出报告,不修改仓库或 GitHub 状态。 - 用户明确要求加入精选列表且候选通过核验时,先修改 README,再运行官网同步和项目检查。 - 描述使用自然中文,技术术语保留英文,不照抄英文仓库简介。 - Star 使用核验时的真实值;无法读取时省略并说明,不得猜测。 - “官方”“生产级”“最大”“首个”等词只有在证据充分时才使用。 - 高风险项目的收录文案必须写清依赖和适用边界,不能暗示无风险全自动运行。