在 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 的仓库治理、版本、发布或渠道联动。
然后执行只读盘点,不要先改文件:
- 先选定本轮唯一写入库:私有母库或公开分享库。
- 读取项目级
AGENTS.md、CLAUDE.md和现有台账。 - 检查 Git 状态、远程地址、当前版本和工作区修改。
- 查找重复 Skill、历史包、平台副本和来源信息。
- 明确本轮模式、范围、验收标准和高风险边界。
可以运行:
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。
许可证决策
发布前先按文件类型判断,不用一个许可证笼统覆盖所有材料:
- 原创
SKILL.md、references、README/docs 与原创 assets 默认CC-BY-NC-SA-4.0; scripts/和仓库tools/中的实质软件代码默认PolyForm-Noncommercial-1.0.0;adapted/与第三方内容始终服从上游许可证,保留ORIGIN.md、版权和修改记录;- 企业内部普通办公可按
ADDITIONAL-PERMISSIONS.md免费使用;收费课程、转售、客户交付、SaaS、代运营等必须走COMMERCIAL-LICENSE.md; - 每个 Skill 都要在 frontmatter 和
registry.json写license;含scripts/的原创 Skill 还写code_license; - 历史 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.mdagents/references/scripts/assets/
生成后必须:
- 列出 ZIP 内容;
- 确认包结构为
<slug>/SKILL.md,同级放agents/、references/、scripts/、assets/; - 在临时目录解压,并确认恰有预期的
SKILL.md; - 执行随包脚本的代表性测试;
- 计算 SHA256;
- 记录版本和证据。
6. 在公开分享库独立制作公开版
- 在私有母库中只读理解功能目标,不复制文件。
- 结束私有库阅读,切换到独立的公开分享库。
- 仅使用公开资料和明确许可材料,在分享库重新写公开版。
- 在分享库独立确定版本、来源、许可证和测试夹具。
- 运行公开库自己的隐私、来源、许可证和功能校验。
- 人工检查公开 diff 与包清单后,再进入发布。
禁止 Git 子模块、共享工作树、符号链接、cp / rsync、跨库相对路径或 CI 拉取私有库。
7. GitHub 发布
按顺序执行并读回:
- 确认当前目录和 remote 都属于公开分享库;
- 提交并推送公开源码;
- 等待 GitHub Actions 校验成功;
- 为单个 Skill 生成版本化 Release;
- 上传 ZIP 和 SHA256;
- 用公网地址实际下载并复验;
- 记录源码、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 对账
按来源分类:
- 当前选定仓库已有的运行副本
- 社区或市场安装项
- 本地实验项
- 来源未知项
只在运行副本包含母库没有的新修改时进入恢复流程:
- 以所属仓库的“上次正式版本”为基准,对真源、正式版本、WorkBuddy 做三方比较;
- 复制 WorkBuddy 当前副本到带时间和版本的隔离恢复区;
- 比较文件、版本和哈希;
- 判断新旧方向;
- 人工确认后合并;
- 重新走完整发布链。
如果 WorkBuddy 明确比母库旧且没有独有修改:
- 记录旧文件清单和哈希;
- 生成可恢复副本;
- 获得覆盖确认;
- 用已验证的 Release 包更新;
- 重载或重新打开运行工具;
- 执行最小触发测试;
- 失败时恢复旧副本。
不要把平台安装目录批量倒回任何真源仓库,更不要跨库回收。
SkillHub 的最终提交、删除旧附件和批量迁移保留用户确认。
10. 收口与留下证据
最终报告使用:
| 状态 | 含义 |
|---|---|
| PASS | 已执行并有读回证据 |
| REWORK | 已执行但未达到验收标准 |
| UNCOVERED | 本轮范围内尚未执行 |
| BLOCKED | 连续验证后仍依赖外部变化 |
报告必须包含:
- 改了什么
- 哪些测试通过
- 源码、安装包、GitHub 和飞书入口
- 工作区与远程是否一致
- 未验证项和残余风险
- 下一次最小升级动作
详细检查表见 references/operating-checklists.md。
持续升级机制
每次真实使用后,把反馈分成:
- 触发问题
- 流程缺口
- 平台变化
- 质量门禁不足
- 用户理解成本
- 自动化机会
遵循同一循环:
真实任务
→ 记录证据
→ 找到最小改动
→ 更新所属真源和版本
→ 重跑该仓库自己的交付闭环
→ 读回验证
不要为一次偶发现象无限扩张 Skill。重复出现两次以上,或会影响发布正确性、来源可信度和隐私安全时,再沉淀为正式规则。
最终质量门禁
- 本轮是否只写入一个已明确选择的真源仓库?
- 两库之间是否仍然没有复制、镜像、同步或一键公开链路?
- 本轮是否更新了原有 Skill,而不是制造重复 Skill?
- 版本号和变更范围是否匹配?
- 来源、作者和许可证是否清楚?
- 是否区分了限制商用与 ShareAlike/Copyleft?
- Skill 内容、实质代码和第三方材料是否分别标明许可?
- ZIP 是否实际解压测试?
- GitHub Actions、Release 和下载是否读回?
- 飞书页面是否写后读回?
- WorkBuddy 副本是否保持下游身份?
- 高风险动作是否保留用户控制权?
- 台账和下一次升级入口是否更新?
三端入口
- GitHub 源码:https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-skill-lifecycle-manager
- GitHub Release:https://github.com/PhilRobinluo/ai-coevolution-skills/releases/tag/lls-skill-lifecycle-manager-v3.0.0
- 飞书中文教程:https://m2wlgni9k4.feishu.cn/wiki/IunjwDVWSiHmZfkeJLgcikjpnEc
- SkillHub:https://skillhub.cn/skills/lls-skill-lifecycle-manager