metago-completeness-guard

name	metago-completeness-guard
description	完整性治理——把"完整"从主观断言变成机器可验证的检查。当需要宣称任务/方案/文档"完成""完整""完美"时，必须先运行完整性验证并生成标准声明；禁止使用禁用声明词（绝对完整/100%完美/不会再缺等）。提供验证引擎、活基线、缺口登记册、完整性雷达、强制门的使用方法。
version	1.0.0
author	MetaGO
category	元构工程质量族
platforms	["trae","claude-code","codex","cursor","codebuddy","qoder","zcode","chatgpt-work","workbuddy","kimi-code","kimi-work"]
trigger	["宣称完成","宣称完整","交付前","验证方案","缺口登记","完整性检查"]

元构完整性治理（MetaGO Completeness Guard）

核心原则（不可违反）

1. 完整性 = 基线覆盖全绿，不是主观断言——宣称完整前必须运行验证，输出覆盖报告；
2. 缺口可见——所有未覆盖项必须登记（可见的缺口优于隐藏的完美），不存在"没发现=没有"；
3. 声明纪律——禁止使用禁用词：绝对完整 / 100%完美 / 100%完整 / 不会再缺 / 不可能有遗漏；标准声明格式：

   "当前基线（Vx，N 项）覆盖全绿 + 已知缺口 M 项已登记"

4. 基线是活的——新框架/新标准/新功能 → baseline add 纳入基线 → 重新验证；
5. 完整性是持续治理——定期 radar check 扫描行业/竞品/元构升级，不是一次达成。

操作流程（强制按序）

1. 初始化：completeness-guard init --target <项目目录>（生成配置 + 缺口登记册 + 雷达档案）
2. 验证：completeness-guard verify --doc <文档路径>——全绿（exit 0）才允许宣称完整；有缺口 → 补齐或登记后重跑
3. 登记缺口：completeness-guard gaps add "<缺口描述>" --source <来源> --plan <计划>（来源：用户/雷达/自审）
4. 雷达：completeness-guard radar check——过期则按观察清单扫描行业新标准/竞品新功能/元构升级，发现 → gaps add 或 baseline add
5. 声明：completeness-guard declaration --doc <路径>——生成标准声明（替代"我做完了一切都完整"式断言）

强制门（安装后自动生效）

• PreToolUse 拦截：输出含禁用声明词时返回拦截（hooks 已配置时）；
• Stop 触发：会话结束时若存在未验证交付，生成提醒；
• CLI 门禁：completeness-guard verify 失败 exit 1——CI 可接入，失败即阻断发布。

配置要点

• completeness.config.json：target（文档路径/版本）、baselines（启用基线）、enforcement（强制等级/禁用词/hooks）、radar（扫描周期）、gaps（登记册路径）；
• 自定义基线：completeness-guard baseline add <组> <条目> <关键词...> 或编辑 baselines/user-custom.json。

与本技能配套的资产

• CLI：completeness-guard（verify/init/baseline/gaps/radar/declaration/check-text）
• 基线：B1 权威框架 / B2 行业标配 / B3 协议标准 / B4 自解剖 / B5 元构法则 / B6 竞品对标 / B7 用户自定义
• 本技能即"软强制层"（教会 Agent 遵守）；hooks 为"硬强制层"（不可绕过）。