dev-govern
Skill1 starsChanged yesterdayMITView on GitHub
代码体检、清技术债、安全与规范审计、重构治理、同步 AGENTS/TDD、reconcile、规则下沉、园艺聚类、sample 事后抽检与跨多版本发版筹备(release-prep)。 触发词:代码体检、清技术债、审计、重构治理、同步 AGENTS/TDD、reconcile、仓库巡检、 清理过期 worktree、检查 deadcode、安全扫描、治理计划、批量提 Issue、技术债盘点、 规则下沉、园艺聚类、sample 抽检、arch-rules 检查、release-prep、发版筹备、汇总更新日志。
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- dev-exploreSkill
- dev-flowSkill
- dev-planSkill
- dev-reviewSkill
- project-forgeSkill
The file
Files
dev-govern
对仓库做只读代码体检、分批重构治理、契约与工作树巡检(reconcile)、园艺信号聚类及历史抽检,
全部入口收敛在:node .agents/skills/dev-govern/scripts/govern-audit.mjs。
组合工作模式与新增子命令
默认只读,先出事实与 [GAP_SCAN],再按需出计划、聚类、抽检或生成 Issue:
# 1. 只读审计、基线增量与模块聚类(支持 security,deadcode,tests,docs,hygiene,perf)
node .agents/skills/dev-govern/scripts/govern-audit.mjs audit [--scope src] [--categories security,tests,docs] [--cluster]
node .agents/skills/dev-govern/scripts/govern-audit.mjs audit --save-baseline # 快照存量基线至 <mainRoot>/.worktrees/.state/govern-baseline.json
node .agents/skills/dev-govern/scripts/govern-audit.mjs audit --changed # 增量只报改动文件或新增/恶化项(--all 强制全量)
# 2. 分批计划(--write-todo 生成标准 Frontmatter `-todo.md`)/ 多轮收敛 / 安全生成 GitHub Issue
node .agents/skills/dev-govern/scripts/govern-audit.mjs plan [--write-todo] # 兼容 --plan-only
node .agents/skills/dev-govern/scripts/govern-audit.mjs audit --execute --loop
node .agents/skills/dev-govern/scripts/govern-audit.mjs issues [--apply-issues] # 兼容 --issues
# 3. 园艺信号记录、聚类、事后抽检与闭环复盘
node .agents/skills/dev-govern/scripts/govern-audit.mjs record --pattern <key> --message "<text>" [--module <dir>] [--file <path>]
node .agents/skills/dev-govern/scripts/govern-audit.mjs cluster [--signals-only]
node .agents/skills/dev-govern/scripts/govern-audit.mjs sample [--commits 30]
node .agents/skills/dev-govern/scripts/govern-audit.mjs retro [--task <id>] [--apply-patches] [--json]
# 4. 跨多版本人类可读发版筹备(支持跳跃自定义号、浅克隆警告与多子包版本聚合)
node .agents/skills/dev-govern/scripts/govern-audit.mjs release-prep [--from <tag|rev>] [--to HEAD] [--version <ver>] [--json]跨多版本发版筹备(release-prep)
只读采集并净化任意发版区间的变更事实,适配发版说明目录或 CHANGELOG.md(支持自由定制章节、不留空节):
- 区间与自定义定号:自动探测
--to之前最新可达标签(无标签仓库则追溯至根提交覆盖全史;传--from时严格尊重基线),继承现有标签v前缀,支持--version跳跃升级(如v1.0.0直跳3.0.0/v4.0.0)。 - 权威版本与下限预警:汇总
SKILL.md、package.json、pyproject.toml、Cargo.toml、manifest.json版本源,并提取engines/requires-python/rust-version/go/minAppVersion等最低运行版本变更写入breakingSignals。 - 双源降噪与防漏交叉核对:过滤纯测试/夹具、CI 内部、
.worktrees、纯错字/排版及未触及公开入口的内部重构提交;清洗去掉内部编号进入userFacingCandidates,同步采集合规规格(implemented)与归档成果;标出publicSurfaceTouched及仅落在含糊提交里的unaccountedPublicFiles。 - 发版纪律:只写最终用户可感知变化与升级步骤,绝不照抄内部提交流水账;未经人明令严禁打标签或改写已发历史。
工程契约巡检(reconcile)
当怀疑契约文档、架构边界或隔离目录漂移时运行 reconcile(只读):
node .agents/skills/dev-govern/scripts/govern-audit.mjs reconcile- 契约体积与失效引用:
AGENTS.md达24576字节预警、超30720字节报危,校验反引号路径、默认分支与Dev Profile(含过期high-risk:零匹配检查docs.devprofile-unmatched-high-risk)。 - 文档温差、相对死链、Mermaid 与活跃 Frontmatter:对照最近 80 次提交热点目录检查文档滞后(
docs.stale-vs-churn),扫描活跃目录 Markdown 相对死链(docs.dead-link,跳过docs/archive/历史归档)、Mermaid16/12防截断宽度(docs.mermaid-label-width)、docs/TDD.md模块漂移(遵循readDecisions的no-tdd/ 既有架构文档豁免),以及docs/{prd,specs,todo}/活跃文档的 YAML Frontmatter、-issue<N>-与related_*互链。 - 结构腐化与跨层边界:识别墓碑履历注释(
hygiene.tombstone-comment)、借口/压制标记(hygiene.excuse-suppression)、连续注释死代码块(deadcode.commented-block)、>800/>1500行超大源码(hygiene.god-file)与arch-rules:跨层禁引违规(hygiene.arch-boundary)。 - 测试覆盖与 CI 对齐:聚合根与多子包脚本(
package.json、Makefile、justfile、pom.xml、Cargo.toml等)、.github/workflows/及中性 CI 配置(.circleci/config.yml、azure-pipelines.yml、Jenkinsfile等)与Dev Profile输出testInventory,揪出零断言、全跳过与孤儿测试套件(tests.orphan-suite)。 - Worktree 四态精细判定:在 worktree 内运行同样以
<mainRoot>/.worktrees/为基准,结合git cherry与git patch-id识别merged、squash_or_rebase_merged、no_own_commits(仅报告并要求先问人核对未提交改动,绝不误删)与unmerged。 - 清单与仓库卫生:校验
.agents/skills/.pf-manifest.json(兼容 v2 定制豁免与跨系统换行)、明文凭据、>1MB大文件、macOS 元数据过滤及未忽略输出目录。
测试分层、控频与质量治理
- 客观盘点与无 CI 诚实汇报:汇总多构建工具脚本与测试目录生成
testInventory;无.github/workflows等 CI 配置且存在测试时发出tests.no-ci-config(low),明示仅核对本地Dev Profile与脚本目录。 - 分层分离与
{target}窄化:拦截quick-test与full-test/merge-gate合并或混入 Playwright/Cypress/Puppeteer/Selenium/Testcontainers/Docker Compose(tests.collapsed-tiers),以及测试文件>= 5却未配置{target}/--filter/--changed的无过滤快测(tests.unfiltered-quick-test)。 - 三段测试控频:编码中只做语法/类型/单文件检查;一轮改动后跑
flow.mjs verify --tier quick --target <path>;合入前集中跑 1 次full-test与merge-gate。 - 反膨胀与假测审计:剥离注释并跳过元夹具生成器后,识别非 E2E 单测硬编码
>=1ssleep(tests.hard-sleep)、单测混入浏览器/容器重依赖(tests.heavy-in-unit)、>=5mock 且仅断言调用次数而 0 真实值断言的纯 Mock 自证(tests.mock-tautology)、>800行超大单测(tests.oversized-file)与无环境变量隔离的非无头配置(tests.non-headless);重组或拆分测试目录前须先请人类确认。
信任倒金字塔与规则下沉阶梯
- 防线顺序(倒金字塔):确定性静态护栏(类型、
arch-rules、卫生脚本)与高频测试优先于人工或事后复审;能用静态门禁拦住的问题绝不依赖口头叮嘱。 - 规则下沉阶梯:
- 第 1 次出现(L1):当场修根因,并用
record记入园艺缓冲<gitCommonDir>/project-forge-govern/signals.jsonl(零污染git status)。 - 重复达
>= 2次(L2):cluster/audit --cluster按「模块 + 模式」去重标出sinkCandidate,必须把规则下沉到AGENTS.mdDev Profile(arch-rules/smoke-verify)或对应验证脚本,并在报错文本中直接给出根因修法。 - 高频或 3 次以上(L3):提升为硬门禁并在 CI 工作流强制执行。
- 第 1 次出现(L1):当场修根因,并用
园艺缓冲聚类、事后抽检与顽固 Bug 三步止损
- 园艺缓冲与批清理:定期用
cluster汇总signals.jsonl与现场审计发现,按模块+模式一次性整片清理,不在同一文件叠补丁。 - 事后历史抽检与任务复盘(
sample/retro):定期运行sample --commits 30统计Revert与 48 小时返工热点;任务合入后运行retro [--task <id>] [--apply-patches] [--json]自动读取dev-flow(verify/rework)与dev-review(record--disposition)自动沉淀的<gitCommonDir>/project-forge-govern/signals.jsonl,统计无效审查率并产出规则/门禁/夹具建议补丁,反馈给下轮dev-plan。 - 顽固 Bug 三步止损:同一模块或同一缺陷连续尝试修复 3 次仍复发或退回时,立即停手止损,禁止继续试错打补丁;用
sample与cluster复盘架构边界与回归测试缺口,交由人类维护者拍板方案后再动。
与其余四套研发技能的联动
dev-explore:遇到docs.missing-tdd、docs.tdd-module-drift、hygiene.god-file/arch-boundary或准备执行retro规则下沉前,先跑node .agents/skills/dev-explore/scripts/repo-map.mjs摸清真实模块入口与reusableModules,再落笔治理或修订docs/TDD.md。dev-plan:govern-audit.mjs plan --write-todo生成符合统一模板的标准 Todo 并可直接通过doc-plan.mjs audit;命中跨模块债或retro建议整改时,自动指引先走doc-plan.mjs triage(L3 建SPEC + Todo)。dev-flow:按分批计划执行时通过flow.mjs start --todo <path>在独立工作树推进、reconcile检出过期 worktree 后由flow.mjs cleanup四态安全清理;flow.mjs verify/rework自动向signals.jsonl写入运行时信号供retro消费(lightweight档缺省兄弟技能时自动降级为原生 Git 指引)。dev-review:每轮整改与规则下沉后运行AGENTS.md全部验证命令,再用review-pack.mjs --local收口确认;review-pack.mjs record的--disposition反馈自动入库signals.jsonl。
执行与安全护栏
- 只读先行与不擅自删目录:
--audit-only、--plan-only、reconcile、cluster、sample、release-prep与不带--apply-issues的--issues均为只读;清理任何.worktrees/(尤其no_own_commits)前必须列清单请人确认并先解绑依赖链接。 - Issue UTF-8 安全提交:带
--apply-issues时一律写系统临时目录 UTF-8 文件配合gh issue create --body-file提交并删除临时文件。 - 规则下沉与去熵:真实审查漏出或运行时复发满
2次的同类故障,必须下沉为确定性形式静态检查或静态门禁脚本,防止反复靠人工读代码拦错;同步清理死代码、废弃路径与冗余分支,保持代码库精简。 - 验证收口:修复与下沉完成后运行
AGENTS.md中的全部验证命令与静态/实证门禁,再使用dev-review(review-pack.mjs --local)收尾确认。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

