mcpField
S
skillport-distribution-system

skillport-distribution-system

github.com/arthurzakirovAgent 工作流0164 次安装5 周前更新
代码仓库

关于 skillport-distribution-system

skillport-distribution-system 用于打包、安装和跨设备同步可复用 Agent 技能，面向维护多仓库技能包的用户。它通过清单和脚本协调不同工具环境中的共享技能存储与刷新。

主要功能

  1. 01生成技能包仓库
  2. 02按清单安装和同步技能
  3. 03支持 Codex、Claude Code 和 OpenCode
  4. 04按平台刷新全局指引
  5. 05控制推送范围并执行安全检查

适用场景

  1. 01为新技能创建仓库骨架
  2. 02在多台设备上同步技能
  3. 03为不同工具环境安装共享技能
  4. 04安排技能与指引的自动刷新

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/skillport --skill skillport-distribution-system

安装后在 Claude Code 中输入/skillport-distribution-system确认已加载。

详细介绍

SkillPort 分发系统

目的

将可复用的 Agent 技能打包一次，即可在多台机器、多人、多个仓库和多个执行环境之间安装和共享，包括 Codex、Claude Code 和 OpenCode，并使用共享的本地技能存储。

使用此工作流

创建新的技能包仓库时：

  1. 在打包文件之前，确定仓库的产品名称、标识和定位。
  2. 开始创建新的技能包时，在 SkillPort 仓库中运行 scripts/create-agent-skill-repo.sh。
  3. 检查生成的占位内容、插件清单、README、示例、架构和安装脚本。
  4. 添加或更新实际技能。
  5. 将 GitHub 仓库简称添加到 SkillPort 清单中，通常是 config/skill-repos.local.yaml。
  6. 在本地进行验证：
npx skills add /path/to/generated/repo --list
  1. 推送到 GitHub。
  2. 从 GitHub 进行验证：
npx skills add https://github.com/OWNER/REPO --list

要在多台机器之间进行常规同步，请使用：

./scripts/skillport-sync.sh

此操作会针对所选清单中列出的每个仓库，重新运行 npx skills add <repo> --skill '*' -a codex -g -y，然后运行 npx skills update -g -y。

将个人仓库列表保存在被忽略的本地文件中，例如 config/skill-repos.local.yaml，或者通过 --repos-file 传入单独的清单。公开的 SkillPort 仓库应只包含通用示例清单。

常规机器设置请使用同步脚本。仅在本地积极开发且需要在推送前实时查看编辑结果时，才使用本地符号链接脚本。

GitHub 模板规则

GitHub 模板仓库会复制整个仓库，不能直接将某个子目录用作模板。

常规 SkillPort 工作流请使用生成器。只有在需要使用 GitHub UI 或 gh repo create --template 流程时，才创建单独的精简 GitHub 模板仓库。

与框架无关的安装和全局规则

使用 npx skills add <repo> --skill '*' -a codex claude-code opencode -g -y 配置基线。检查 CLI 输出以及 npx skills ls -g -a codex claude-code opencode：Codex 和 OpenCode 直接使用 ~/.agents/skills；Claude 的路径是指向该操作系统对应目录树的别名。切勿为每个框架添加可编辑的内容副本。

在 Windows 和 WSL 之间共享一个规范的仓库检出，通过 Windows 路径和 /mnt/c 访问。生成的安装内容可以按操作系统分别保留，以便每个安装程序维护自己的路径，同时不影响其他无关的技能。其他实体设备使用单独的 Git 同步检出。

全局指导内容的生成由 AgentDesk 负责。编辑 AgentDesk global-guidance/，然后运行 AgentDesk scripts/regenerate-agents-md.py；SkillPort 仅在刷新期间调用 AgentDesk 的生成器，不得附带第二套可编辑的生成器或指导内容副本。它还会配置 Claude 导入项和 OpenCode 的全局 JSON instructions，而不会重复存放可编辑规则。首次迁移需要进行比较并明确替换；先前生效的内容会备份。保留和验证步骤请参阅 docs/cross-device-maintenance.md。不要假设任意框架都支持相同的全局路径或导入语法。

若要无人值守地刷新，请设置 SKILLPORT_ROOT，并使用 macOS LaunchAgent 安装程序或原生 Windows Task Scheduler 安装程序，以及私有的机器配置。仓库注册表和全局指导层都使用 AgentDesk 检出；不要重复存放仓库清单、指导源、机器路径或对 Shell 启动方式的假设。macOS 会在登录／加载时运行，并将唤醒触发的任务合并到每刻钟运行一次。Windows 会在登录时运行，并每隔 15 分钟运行一次，同时启用 StartWhenAvailable；这样可以避免依赖易出问题的审计策略的解锁事件订阅。两者都只刷新注册表中选定的规范检出，组合正确的平台指导内容，并重新安装明确指定的远程技能子集。核心操作无需 GitHub CLI；它仅用于实时验证推送可见性。元数据缺失或验证失败时，会跳过推送，但不会阻止刷新。可选推送仅限注册表范围，并采用默认拒绝策略：私有仓库必须验证为私有可见性并通过凭据扫描；公共仓库还必须获得针对确切已审阅 HEAD 的批准，并通过个人数据扫描。自动化绝不会暂存或提交文件。

当某个工作流的指令和支持事实应当放在一起时，将它们打包为一个可安装的技能，并把所有参考资料放在该技能目录内。通过危害与收益审查选择公开或私有可见性；公开材料应先脱敏，并避免依赖跨仓库的运行时内容或另建一份权威的旁置资料。

评论

支持 Markdown