SuperAPI AI 工具集

ppt-release

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:把“准备并发布一个版本”变成一条有意识的命令,避免每次手工重新推导发布清单。它针对待发布 diff 执行仓库既有的质量门禁(已安装 sip、re0-git 时运行它们,未安装时直接套用其检查),并把“提交”和“打标签+推送”视为两个分别确认的时刻:提交留在本地、可回退;打标签+推送是唯一对外公开的一步。

主要能力与流程:1) 对照待发布 diff 确认可发布性,检查新增或改动的 SKILL.md 结构(frontmatter 的 name+description、仅用户调用时才用 disable-model-invocation、正文含 Goal/Workflow/Rules/Verification),README 及 docs/readme/ 下各本地化副本是否准确列出并标注正确的 Invoker 列,plugin.json 是否注册路径,重命名是否按发布顺序向 ppt-upgrade 的弃用清单追加 old -> new 行,以及跨技能共享规则是否在各副本中保持一致;发现缺口即报告并停止,不猜测跳过。2) 判定版本号变更类型:新增技能为 minor,修复或仅文档改动为 patch,移除技能且无替代路径为 major,并说明理由。3) 若已安装 sip 则运行并采纳其发现;未安装则按顺序直接执行其检查:cold-read(shower)、仅在存在声明或评测时做 truth checks(factchk/mandela)、一致性(ssotchk/ssotize)、整理(re0)。4) 按第 2 步结论更新 package.json 版本。5) 按 commit-economy 起草提交信息:每条真实持久事实一个要点,不写 diff 或版本已能证明的内容,不加 co-author 标签,匹配本地日志形态;若已有提交需清理,已安装 re0-git 时按同样方式重写。6) 请求明确确认后提交。7) 写入 .ppt/release/RELEASE_NOTES.local.md(被 gitignore、永不发布的本地草稿,作为签名标签的消息),遵循固定风格:一个 ## 标题命名本次发布的持久理念而非版本号,一段现在时的简短说明,只保留本次发布应得的章节(### New、### Also、仅在需要重映射名册时用 ### The catalog (N skills)、### Install 始终以缩进块置于最后),技能名与路径用反引号,不写标签或版本已能证明的内容。8) 打标签并推送前请求第二次独立确认,然后执行 git tag -s vX.Y.Z -F .ppt/release/RELEASE_NOTES.local.md --cleanup=verbatim,推送 main 与标签。9) 观察触发的发布工作流直至完成,报告成功或实际失败,不假设已落地。

规则与限制:不得臆造或假设 CLI 命令或参数,写入执行步骤前须对照官方文档或真实运行验证;若待发布 diff 混杂无关关注点,应先说明并建议拆分;本地版本未匹配(package.json 等于即将创建的标签)前绝不推送,CI 检查只是兜底。完成前需确认 package.json 版本与标签一致、提交信息可独立作为清晰交接、发布说明符合风格且只提本次应得内容、推送标签触发的工作流已成功完成(需确认而非假设),并报告任何跳过步骤或未解决缺口。该技能为用户手动调用,具体安装方式与依赖版本暂未提供。