release-discipline

🛑 专治版本泛滥的发布守门人

社区开发者 gyeuun97 打造的发布纪律守门人,通过六大检查关卡强制冷却期、用户反馈验证与文档完整性审查,根治版本泛滥与半成品发布,让每次发布都经得起检验。

收藏
4.2k
安装
924
版本
v1.0.0
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

核心用法

release-discipline 是一款面向 AI Agent 和开发者的发布纪律强制工具,在检测到发布意图(release/publish/deploy/배포 等关键词)时自动激活,执行六层递进式预审关卡:

1. Cooldown Check(24小时冷却期):阻断频繁发布冲动,少于24小时直接拒绝
2. User Feedback Check(用户反馈验证):检查 GitHub issues、npm 下载量等真实使用数据,无人使用的版本不得迭代

3. Documentation Check(文档完备性):README 缺失即阻断,无英文文档警告

4. Quality Check(实质内容审查):要求明确回答"本次发布唯一改进点",禁止模糊表述

5. Kill Criteria Check(终止条件设定):强制定义项目失败标准,防止无限投入

6. Self-Contradiction Check(原则一致性):读取 SOUL.md 等原则文件,发现言行不一立即阻断

通过后在 memory/release-log.md 记录发布日志,并支持每周回顾分析。

显著优点

  • 心理刹车机制:将"发布冲动"转化为结构化反思,特别适合完美主义与拖延症两极的开发者
  • 数据驱动决策:用真实用户反馈替代主观感觉,避免"自嗨式迭代"
  • 原则锚定:通过读取项目原则文件,防止行动与价值观背离
  • 轻量零侵入:纯文档型 skill,不修改代码、不访问网络、不收集数据
  • 反模式针对性:精准狙击版本泛滥(17版/3天)、有始无终、文档债务等常见病症

潜在缺点与局限

  • 刚性门槛可能误伤:紧急安全补丁也需等待24小时冷却,或关键反馈缺失时阻碍必要迭代
  • 依赖外部数据可及性:npm 下载量、GitHub issues 等数据若未公开或平台受限,检查效果打折
  • 主观判断灰色地带:"质量"与"实质改进"的判定标准依赖用户自陈,存在自我说服空间
  • T3 来源信任成本:社区个人开发者维护,长期更新与背书力度有限
  • 非自动化执行:仅作提醒检查,无法真正阻断 CI/CD 流程,最终纪律仍靠自觉

适合的目标群体

  • 独立开发者/Solo Builder:缺乏团队 Code Review 制衡,需外部化纪律约束
  • 开源项目维护者:面临社区压力频繁发版,需建立发布节奏权威
  • AI Agent 工作流设计:为自主 Agent 设置行为边界,防止自动化导致的版本泛滥
  • 产品导向型技术团队:从"功能交付"转向"价值交付"的组织转型期

使用风险

  • 流程摩擦成本:严格检查可能延长发布周期,与敏捷团队快节奏文化冲突
  • 数据隐私顾虑:需向 skill 暴露项目反馈数据(issues、下载量)以完成检查
  • 过度依赖风险:将发布决策外包给 checklist,可能削弱开发者的产品直觉
  • 与其他工具链冲突:若团队已用 semantic-release 等自动化工具,手动关卡可能造成流程断裂

安全解读

核心用法

release-discipline 是一个流程干预型 Skill,专门用于拦截和审查发布/部署/版本升级操作。当用户触发 "release", "publish", "deploy", "version bump" 等关键词时,Skill 会强制执行 6 道质量门禁(Gates):

1. Cooldown Check:24 小时冷却期,防止频繁发布
2. User Feedback Check:验证上一版本是否有人使用

3. Documentation Check:README 和英文文档完整性

4. Quality Check:要求明确说明本次发布的核心价值

5. Kill Criteria Check:项目终止条件是否已定义

6. Self-Contradiction Check:行动是否与自身原则文件(SOUL.md)冲突

所有门禁通过后才允许发布,否则根据严重程度标记为 🛑 BLOCKED 或 ⚠️ WARNING。

显著优点

  • 根治版本泛滥:用硬性约束替代主观自律,有效阻止 "17 个版本 3 天" 的无效迭代
  • 强制文档对齐:阻断 "代码写完文档待补" 的技术债务累积
  • 原则一致性:通过 SOUL.md 对照,防止言行不一的自我欺骗
  • 可追溯性:自动记录发布日志,支持每周复盘与模式分析
  • 零技术债务:纯 Markdown 实现,不引入任何运行时依赖

潜在局限

  • 依赖用户配合:Skill 本身无强制阻止能力,需代理/用户主动遵守判定结果
  • 反馈检查受限:"用户是否使用" 的判断依赖外部数据源(GitHub issues、npm downloads 等),若未接入则判断可能失真
  • 文化适配性:24 小时冷却期在紧急修复场景可能过于 rigid,需人工 override
  • 英文文档要求:对非英语项目可能造成不必要的发布阻力

适合人群

  • AI 代理开发者:防止代理冲动发布、追求版本号增长而非实质进展
  • 开源项目维护者:治理社区贡献中的 "spray without prune" 行为
  • 个人开发者:对抗 " fear of irrelevance " 驱动的无效发布焦虑
  • 团队 Tech Lead:作为发布流程的自动化守门员,减少人工审查成本

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| **流程绕过** | 用户/代理直接忽略 Skill 判定继续发布 | 需配合 CI/CD 钩子或人工审查机制 |
| **误判阻塞** | 紧急安全修复被 24h 冷却期拦住 | Skill 支持 override,但需记录原因 |
| **日志膨胀** | 长期运行后 release-log.md 过大 | Skill 内置每周 review 机制,建议定期归档 |

release-discipline 内容

手动下载zip · 2.3 kB
SKILL.mdtext/markdown
请选择文件