SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场melech

melech

智能体与模型

查看项目

更新于 10-15 08:27

技能介绍

Melech 是 AdirD/agent-shell-hamelech 的元技能（meta-skill），定位为“远程 ↔ 本地技能目录”。它的核心职责是展示远程技能清单、与本地安装状态做差异对比，并推荐相应命令，但不会在未经用户明确要求的情况下静默安装或更新任何技能。

用途

Melech 用于管理 AdirD/agent-shell-hamelech 仓库中的技能集合。用户可以通过以下任一方式调用它：

  • melech
  • melech list
  • melech list skills
  • list melech skills
  • melech status / melech sync

这些调用被视为同一请求：运行目录展示。

主要能力

Melech 以远程优先的方式工作：GitHub 上的每个技能都会作为一行显示，即使尚未安装。每个技能会展示以下字段：

  • name：技能 ID
  • description：来自远程 SKILL.md frontmatter
  • installed：Y / N（记录在全局技能锁中）
  • where：安装位置，包括 global / project / workspace → agents @ path
  • local version：来自锁的短文件夹 SHA，或 -
  • remote version：main 分支上的短文件夹 SHA
  • update available：Y / N
  • status：new / current / outdated / broken-source 等
  • command：用于安装、更新或重装该技能的确切 npx skills … 命令

其中安装位置（where）的含义为：

  • global：用户级安装（npx skills add -g），跨项目共享
  • project：安装到当前项目的 agent 技能目录
  • workspace：裸 skills/<name> 检出发现（作者树，不是安装）

状态（status）的含义及对应命令行为：

  • new：远程存在但未安装，命令为 add
  • outdated：已安装但远程 SHA 不同，命令为 update
  • current：已安装且与远程一致，命令为 add（如被要求则重装）
  • broken-source：锁使用了拼写错误 AdirD/agent-shel-hamelech，命令为使用正确 slug 的 add
  • untracked：已安装但没有本地哈希，命令为 add
  • remote-gone：仅本地存在，上游已删除，命令为 remove

版本号是文件夹树 SHA（Skills CLI 锁），不是 semver。

使用方式

Melech 通过脚本运行。首先解析包含此 SKILL.md 的技能根目录，然后执行：

python3 scripts/status.py python3 scripts/status.py --json

在仓库检出中：

python3 skills/melech/scripts/status.py

运行需要 gh 认证（首选）或 GITHUB_TOKEN / GH_TOKEN。

工作流程如下：

  1. 运行 scripts/status.py
  2. 先给出摘要（远程数量、已安装、新增、更新）
  3. 展示每个技能的卡片（名称、描述、是否安装、位置、版本、更新、命令）
  4. 优先标出 NEW 技能和 UPDATE 行
  5. 展示工作流组合（recipes）及步骤就绪状态 ✓/✗
  6. 仅在获得批准后执行变更，使用每行对应的命令

硬性规则：

  • 绝不运行 npx skills check，因为它会别名到 update 并应用变更。
  • 干跑状态仅使用捆绑脚本。
  • 除非用户明确要求，否则绝不安装或更新。展示目录后等待。
  • 优先使用 scripts/status.py 而非手工抓取。
  • 除非用户要求完整清单，否则仅限定在 melech 技能范围内。

工作流组合

脚本输出中始终包含工作流组合部分。这些组合是来自 README 的旅程配方（不是可安装技能）：

  • Product discovery
  • Better engineering
  • Existing-plan review
  • Shipping

每个组合会展示流程、使用时机以及哪些步骤已安装（✓/✗）。如果步骤缺失，脚本会打印其安装命令。

当用户说例如“install podcast” / “update the outdated ones” / “install the missing steps for product discovery”时，运行目录中匹配的命令。不要编造不同的安装行。优先使用命名命令而非盲目的 npx skills update -g。任何变更后，重新运行脚本并展示新的摘要。

本地开发与多仓库零偏差同步

在本地开发或编辑此仓库中的技能时，使用本地同步工具保证所有开发仓库和 agent 文件夹之间零偏差：

检查是否有本地开发仓库或全局 agent 目录发生偏差：

python3 scripts/sync-local-skills.py --check 或： python3 skills/melech/scripts/status.py --local-check

立即同步所有本地使用：

python3 scripts/sync-local-skills.py --apply 或： python3 skills/melech/scripts/status.py --sync-local

适用场景

Melech 适用于需要管理 AdirD/agent-shell-hamelech 技能集合的用户，尤其是希望了解远程技能与本地安装差异、查看可用更新、按工作流组合安装缺失步骤的场景。它也适用于本地开发技能时需要在多个仓库和 agent 目录之间保持同步的情况。

限制

Melech 不会静默安装或更新技能，必须获得用户明确批准。它需要 gh 认证或 GITHUB_TOKEN / GH_TOKEN 才能访问远程仓库。版本使用文件夹树 SHA 而非 semver。工作流组合不是可安装技能，而是来自 README 的旅程配方。