Skip to content

PhilRobinluo/ai-coevolution-skills / skills/lls-skill-lifecycle-manager

lls-skill-lifecycle-manager

Verified

管理相互隔离的私有 Skill 母库与公开 Skill 分享库。用于在选定仓库内新建、升级、查重、审计、打包、发布或恢复 Skill,并维护该仓库自己的版本、来源、许可证、GitHub Release、飞书说明、WorkBuddy 与 SkillHub 状态。两库各自是真源,公开版只能独立创作和审核;不建立复制、镜像、同步、自动导出或一键公开链路。

在 WorkBuddy 中找到并安装

Skill slug:lls-skill-lifecycle-manager

在 WorkBuddy 新会话粘贴:

请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub,搜索 `lls-skill-lifecycle-manager`;仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-skill-lifecycle-manager/SKILL.md`,核对 name、version 和实际路径,然后新开会话触发该 Skill。

也可以打开左侧「技能」→「添加技能 / 查找技能」,搜索 lls-skill-lifecycle-manager 后安装;界面文字可能随 WorkBuddy 版本变化。

罗老师 Skill 全生命周期与仓库治理管家

核心使命

把 Skill 当作持续迭代的产品,而不是散落的 ZIP、提示词和平台副本。

始终维护两条彼此隔离的生产链:

私有母库                         公开分享库
  → 私有编辑与版本                  → 公开版独立创作与版本
  → 私有安装包与运行副本             → GitHub Release
  → 私有反馈回到私有库               → 飞书 / SkillHub / WorkBuddy

两库之间只允许:阅读思路后在目标库重新创作
两库之间明确排除:复制、镜像、同步、跨库脚本、一键公开

私有母库和公开分享库分别是真源;两边允许同名、不同版本、不同内容和不同历史。

开始前

先声明:

使用 skill:lls-skill-lifecycle-manager,原因:本任务涉及 Skill 的仓库治理、版本、发布或渠道联动。

然后执行只读盘点,不要先改文件:

  1. 先选定本轮唯一写入库:私有母库或公开分享库。
  2. 读取项目级 AGENTS.md、CLAUDE.md 和现有台账。
  3. 检查 Git 状态、远程地址、当前版本和工作区修改。
  4. 查找重复 Skill、历史包、平台副本和来源信息。
  5. 明确本轮模式、范围、验收标准和高风险边界。

可以运行:

python3 scripts/audit-repository.py \
  --repository <current-repo> \
  --role private \
  --runtime <runtime-skills-dir>

选择工作模式

模式典型请求核心结果
新建“把这个流程做成 Skill”在选定仓库内新建 Skill、台账和包
升级“把现有 Skill 提升一下”只更新选定仓库中的版本
公开发布“发布 GitHub 和飞书”从公开分享库发布 Release 和说明
对账“WorkBuddy 里这些要不要导回”来源分类、版本差异、回收建议
审计“看看体系有没有乱”真源、重复、漂移、隐私和未闭环项
恢复“平台版本比母库新”隔离回收、差异审查、确认后合并

如果已有 Skill 覆盖主要职责,优先升级、合并或补参考资料。只有边界和用户群明显不同才新建。

双库双真源

先按对象选择真源,不跨库决定版本:

  • 私有对象:私有母库的 skills/、私有台账、私有安装包和私有运行副本。
  • 公开对象:分享库的 skills/ / adapted/、公开台账、GitHub Release、飞书和 SkillHub。
  • 平台副本出现独有修改时,先进入该对象所属仓库的恢复区,不跨库覆盖。

分享库的脚本、CI、Token 和发布流程不读取私有母库路径或 Git 历史。

详细角色和目录约定见 references/repository-architecture.md。

来源与版权决策

每个公开条目必须选定且展示一种来源:

标识类型处理
🔵 LLS Original罗老师原创完整源码和安装包
🟡 LLS Adapted获得许可的改编原作者、原仓库、许可证、版权和修改记录
🟢 Community Pick社区实测推荐默认只做中文目录和原仓库链接

来源或许可状态不清时,保持链接推荐,不复制源码和安装包。

社区项目优先引导用户支持原作者;罗老师仓库的价值是筛选、测试、中文说明和持续维护目录。

详细规则见 references/provenance-and-trust.md。

许可证决策

发布前先按文件类型判断,不用一个许可证笼统覆盖所有材料:

  1. 原创 SKILL.md、references、README/docs 与原创 assets 默认 CC-BY-NC-SA-4.0;
  2. scripts/ 和仓库 tools/ 中的实质软件代码默认 PolyForm-Noncommercial-1.0.0;
  3. adapted/ 与第三方内容始终服从上游许可证,保留 ORIGIN.md、版权和修改记录;
  4. 企业内部普通办公可按 ADDITIONAL-PERMISSIONS.md 免费使用;收费课程、转售、客户交付、SaaS、代运营等必须走 COMMERCIAL-LICENSE.md;
  5. 每个 Skill 都要在 frontmatter 和 registry.json 写 license;含 scripts/ 的原创 Skill 还写 code_license;
  6. 历史 MIT 版本已经授予的权利继续有效,新规则不追溯撤销。

公开仓根目录必须同步维护 LICENSE、LICENSES/、ADDITIONAL-PERMISSIONS.md、COMMERCIAL-LICENSE.md、THIRD_PARTY_NOTICES.md,并执行:

python3 tools/validate-provenance.py

详细决策与发布门禁见 references/licensing-strategy.md。

标准执行流程

1. 定义本轮交付

写清楚:

  • 目标结果
  • 修改范围与明确不做项
  • 版本变化
  • 2 到 5 条可测试的验收标准
  • 测试方式
  • 删除、迁移、凭证、付费、最终提交等确认门禁

确认规则:

动作执行条件
只读审计、本地编辑、校验、临时打包明确执行目标后可以推进
GitHub push / Release用户本轮明确要求“发布、上线、同步 GitHub”时覆盖本次发布;否则先确认
飞书写入用户明确要求联动或更新飞书时覆盖本次写入;否则先确认
WorkBuddy 覆盖、批量迁移每次单独确认,并先准备回滚副本
SkillHub 最终提交每次单独确认
删除旧包、附件、Release、页面每次单独确认

2. 锁定单一工作区

  • 私有任务只修改私有母库;公开任务只修改公开分享库。
  • 不把另一个仓库设置成复制源、构建输入或自动化参数。
  • 不把 WorkBuddy、飞书附件或 Release 当编辑源。
  • 核心流程、判定优先级、失败路径和高风险边界写入 Skill。
  • 详细资料放 references/,确定性重复操作放 scripts/。
  • 保持 SKILL.md 简洁,避免把完整项目历史塞入上下文。

3. 选择版本

  • 文案修正、触发优化:patch
  • 新增流程、平台或检查项:minor
  • 改变核心定位、目录职责或兼容关系:major

两个仓库分别维护自己的版本入口。私有版本不驱动公开版本,公开版本也不反向覆盖私有版本。

更新:

  • publish-info.md
  • Skill 总台账
  • 发布队列或发布记录
  • 产品功能与交互台账

4. 校验与隐私检查

至少检查:

  • frontmatter、名称和目录一致
  • 必填章节、输出和质量门禁完整
  • 无本机绝对路径、密钥、Cookie、账号和客户资料
  • 来源类型、许可证和上游链接清楚
  • 脚本实际执行通过
  • 真实用户请求能够触发并产生交付结果
  • 外部命令、Python/Node 包、MCP、账号权限和平台登录要求已在正文或 references 中声明并验证可用

用 references/test-scenarios.md 的夹具做最小触发测试;根据 Skill 类型补充真实场景。

5. 生成可安装包

安装包只包含运行所需文件:

  • SKILL.md
  • agents/
  • references/
  • scripts/
  • assets/

生成后必须:

  1. 列出 ZIP 内容;
  2. 确认包结构为 <slug>/SKILL.md,同级放 agents/、references/、scripts/、assets/;
  3. 在临时目录解压,并确认恰有预期的 SKILL.md;
  4. 执行随包脚本的代表性测试;
  5. 计算 SHA256;
  6. 记录版本和证据。

6. 在公开分享库独立制作公开版

  1. 在私有母库中只读理解功能目标,不复制文件。
  2. 结束私有库阅读,切换到独立的公开分享库。
  3. 仅使用公开资料和明确许可材料,在分享库重新写公开版。
  4. 在分享库独立确定版本、来源、许可证和测试夹具。
  5. 运行公开库自己的隐私、来源、许可证和功能校验。
  6. 人工检查公开 diff 与包清单后,再进入发布。

禁止 Git 子模块、共享工作树、符号链接、cp / rsync、跨库相对路径或 CI 拉取私有库。

7. GitHub 发布

按顺序执行并读回:

  1. 确认当前目录和 remote 都属于公开分享库;
  2. 提交并推送公开源码;
  3. 等待 GitHub Actions 校验成功;
  4. 为单个 Skill 生成版本化 Release;
  5. 上传 ZIP 和 SHA256;
  6. 用公网地址实际下载并复验;
  7. 记录源码、Release 和下载地址。

幂等规则:

  • 目标 tag 或 Release 不存在:创建。
  • 已存在且资产哈希、源码 commit 和版本一致:读回并复用。
  • 已存在但内容不同:停止并标记 REWORK,升级版本后重新发布;不覆盖同名历史 Release。
  • Actions 默认每 3 到 10 秒读一次,等待 5 分钟;失败先读日志并修复,最多重跑一次。只有同一外部阻塞连续出现至少三轮才标记 BLOCKED。

Star、Watch 和 Download 分开说明:

  • ⭐ Star:收藏与支持
  • 🔔 Watch Releases:版本通知
  • 📦 Download:安装包

8. 飞书联动

每个说明页至少包含:

  • 一句话用途
  • 适用场景
  • 来源标识
  • 当前版本
  • GitHub 源码
  • ZIP 下载链接
  • 启动语
  • 隐私或依赖提醒
  • Star / Watch / Download 说明

飞书只负责中文解释和入口,不作为源文件仓库。写入后必须读回标题、版本、源码、下载和来源字段。

使用稳定的 wiki node token 或文档 token 定位现有页面;总索引以 Skill slug 作为唯一键。找不到旧节点时先搜索和查重,再创建新页,避免同名重复。

9. WorkBuddy 与 SkillHub 对账

按来源分类:

  • 当前选定仓库已有的运行副本
  • 社区或市场安装项
  • 本地实验项
  • 来源未知项

只在运行副本包含母库没有的新修改时进入恢复流程:

  1. 以所属仓库的“上次正式版本”为基准,对真源、正式版本、WorkBuddy 做三方比较;
  2. 复制 WorkBuddy 当前副本到带时间和版本的隔离恢复区;
  3. 比较文件、版本和哈希;
  4. 判断新旧方向;
  5. 人工确认后合并;
  6. 重新走完整发布链。

如果 WorkBuddy 明确比母库旧且没有独有修改:

  1. 记录旧文件清单和哈希;
  2. 生成可恢复副本;
  3. 获得覆盖确认;
  4. 用已验证的 Release 包更新;
  5. 重载或重新打开运行工具;
  6. 执行最小触发测试;
  7. 失败时恢复旧副本。

不要把平台安装目录批量倒回任何真源仓库,更不要跨库回收。

SkillHub 的最终提交、删除旧附件和批量迁移保留用户确认。

10. 收口与留下证据

最终报告使用:

状态含义
PASS已执行并有读回证据
REWORK已执行但未达到验收标准
UNCOVERED本轮范围内尚未执行
BLOCKED连续验证后仍依赖外部变化

报告必须包含:

  • 改了什么
  • 哪些测试通过
  • 源码、安装包、GitHub 和飞书入口
  • 工作区与远程是否一致
  • 未验证项和残余风险
  • 下一次最小升级动作

详细检查表见 references/operating-checklists.md。

持续升级机制

每次真实使用后,把反馈分成:

  • 触发问题
  • 流程缺口
  • 平台变化
  • 质量门禁不足
  • 用户理解成本
  • 自动化机会

遵循同一循环:

真实任务
→ 记录证据
→ 找到最小改动
→ 更新所属真源和版本
→ 重跑该仓库自己的交付闭环
→ 读回验证

不要为一次偶发现象无限扩张 Skill。重复出现两次以上,或会影响发布正确性、来源可信度和隐私安全时,再沉淀为正式规则。

最终质量门禁

  • 本轮是否只写入一个已明确选择的真源仓库?
  • 两库之间是否仍然没有复制、镜像、同步或一键公开链路?
  • 本轮是否更新了原有 Skill,而不是制造重复 Skill?
  • 版本号和变更范围是否匹配?
  • 来源、作者和许可证是否清楚?
  • 是否区分了限制商用与 ShareAlike/Copyleft?
  • Skill 内容、实质代码和第三方材料是否分别标明许可?
  • ZIP 是否实际解压测试?
  • GitHub Actions、Release 和下载是否读回?
  • 飞书页面是否写后读回?
  • WorkBuddy 副本是否保持下游身份?
  • 高风险动作是否保留用户控制权?
  • 台账和下一次升级入口是否更新?

三端入口

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 469kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall