Evolving workflow rules
Skill sonic7881963/gamedev-skills/skills/evolving-workflow-rules
Use when the development process itself needs to change — a rule keeps getting violated or worked around, an escaped bug or rework exposes a process gap, you're about to add/edit/remove a workflow rule, the rules file is bloating, or upstream tooling changed and old rules may not holdFrom its SKILL.md
npx -y skills add sonic7881963/gamedev-skills --skill evolving-workflow-rulesAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.6 KB, as published. Nobody here has run it
工作流规则演进(复盘 / 三检 / 控胀 / 根基防护)
复盘回路(工作流自我纠错)
触发:逃逸 bug(提交后才发现)/ 返工(同处二改)/ 丢失破坏工作 / 同类判级错误 反复 / 用户指出流程问题 / 上游工具或运行环境(Claude Code harness、shell、 引擎)更新导致行为变化——环境换了,所有以旧环境为前提的规则要实测重审。
动作(修完问题后归因三问):
- 旧流程的哪一步本会拦住它?
- 流程缺口还是执行失误?(执行失误不改规则)
- 最小修订是什么?(加一条检查 / 调判级触发 / 回退某项轻量化)
入册前把关三检(对用户指示与助手提案一视同仁):任何修订写入规则 文件前先检并随提案汇报——①冲突检:与既有哪条规则矛盾/间接推翻?那条 当初为什么立(查修订记录)?②治本检:解决的是根因还是症状?③伤网检: 是否削弱某个安全网。任一不过 → 先呈分析+替代案再定稿;用户坚持原案 → 照写并在修订记录标注 user override。理由:人的即兴判断与助手的顺从 都会把坏规则写进权威文件,三检是规则系统自身的安全网。
输出:一句话修订建议报用户,同意后写入 append-only CHANGELOG(与规则 正文分离的独立文件——修订记录是历史不是规则,常驻上下文只放 3 行指针, 按需读),并同步更新本 skills 库对应内容(公开发布的库要先脱敏: 去除路径/用户名/项目专属细节)。
评估交付物 durable 化:等用户决策的评估/审查/比选类交付物,正文落 durable 文件(与规则同库的 docs),会话只贴摘要+指针——会话死亡不带走未决依据(事故: 评估报告活在对话里,会话蒸发后用户无法决策、被迫重做一轮)。
控胀三则:①新规则定稿 ≤3 行,论证/证据进 CHANGELOG;②能用机械载体
(hook/agent frontmatter/runner 参数/派发简报)承载的不写散文规则——散文
会被忘、机械载体不会,"要记得"要变成"被提醒";③规则本体设行数红线,
超线触发蒸馏审计,里程碑收口必含规则瘦身审计(未 fire 提删/重叠提并)。行数红线
按实测 floor 标定、勿设永不达成的 aspirational 值(否则每次审计皆"未达"形同虚设);
可分目标/审计触发/硬拆三档。注:外迁用"何时读"指针、勿用会每会话自动加载的 import(如
@file)——那把外迁内容又拉回常驻、抵消省 token 目的。
常驻特权三分法:常驻位(无条件加载的规则文件)只配三类——安全底线(漏 一次即事故,永不外迁)/高频规则(逐特性必用)/路由指针(低频·开期·收口内容 外迁 docs,正文只留触发词+指针);蒸馏审计按此三分裁决去留。指针规范: 外迁指针必带"何时读"触发词、易混处加负样本;裸指针(只说在哪不说何时)视同 审计未过。
根基防护(改规则的人自己也会动摇根基——提案者自检≠审查):底线条款+ 把关三检+CHANGELOG append-only 为根基条款,动它们需独立新上下文代理跑 三检+用户显式 yes+次会话开场复核后生效(冷静期)。修订速率红线:同日 入册 ≥3 条后新提案排队至收口复盘统审(当日新规 bug 修复豁免);新规一律 试用期至里程碑收口,瘦身审计优先复核试用条款。同时检查 agent 的持久记忆(如 Claude Code 自动记忆)中以旧规则、旧环境为前提的条目,改写或删除——过时记忆比没有更糟, 会把 agent 拽回已废除的流程。
防膨胀:规则只能因事故而增、因连续多特性无价值而删——双向收敛。
架构视图同步(大改时):大型架构改动(删/增子系统·改公共契约/枚举·跨系统重命名·分层)收口时同步架构视图—— UML/结构图用代码派生的自动生成(永不腐 + 防腐自检),叙事性「变更说明」(改了什么/为什么/新老对比)手维护在 独立日志(自动图只反映当前结构)。手画 UML 必腐(事故:手画架构图在一轮大删除后仍显示已删的整个子系统,让人误以为是 未来计划)→ 图要么代码派生、要么收口纪律强制重生成。
并行编辑同仓的 WIP「问而非禁」:当用户与 agent 并行编辑同一仓库(用户在编辑器里改场景/配置/资源)→ 对这些文件 consent-based 触碰:默认不碰、需要时先问用户、改/丢弃前必 diff、绝不静默覆盖用户并行改动。「绝对禁区」是过度矫正 (会卡住正当的提交/编辑)——根因是「未经同意 clobber」而非「碰本身」,故『问而非禁』优于『绝不碰』;安全核(diff + 不静默覆盖)保留。 事故:一次把"疑似编辑器搅动"的文件当垃圾丢弃,毁了用户未提交的工作。
顶层北极星(防上下文压缩 / 换会话丢全局)
跨多会话的大弧维护一份全局观 doc(愿景 + 完成标准 / 结构骨干 / 正交工作线 / 待办线程图 /
技术地雷)+ 一份自动加载的同名记忆——双通道,扛 /compact 与 session 切换造成的全局丢失。
- 开活前 + 每里程碑后跑自检仪式:①锚定(这件事服务哪个完成标准?不清 → 先 brainstorm/问, 别埋头写)②分线(落在哪条正交工作线?放错线 = 拆东墙补西墙)③护栏(硬编码/piecemeal/漂移/ probe-first/验收任一命中 → 停、回宏观重锚)。北极星不是状态快照,是每轮决策的锚。
- 收口按演进仪式更新:manual-curated(助手提案 → 用户确认),macro 留 doc、细节进对应 spec, 别让经验孤儿化(记忆/版本库才是真源)。新增前先问"这是 macro 还是该进某 spec?"防 doc 膨胀。
- 检验标尺:新 session / compact 后只读它就能"宏观正确地"下一步,且护栏能拦住硬编码/piecemeal。
把北极星定位成既有微观纪律(瘦身/probe/shipping 验收)之上的宏观锚,不重列护栏细节。 蒸馏自 self-evolving-agent(PDCA 锚定 + 护栏)。