Skip to content

lihaozheCharlie/the-way-here / knowledge-engine/skills/common/quality-gate

common-quality-gate

Verified

验证 wiki 或 Skill 修改是否满足证据、归档、前置元数据、生成索引安全、链接和完成标准;纯健康检查保持只读。

FileKindSize
SKILL.mdskill md3.9 KB
---
name: common-quality-gate
description: "验证 wiki 或 Skill 修改是否满足证据、归档、前置元数据、生成索引安全、链接和完成标准;纯健康检查保持只读。"
---

# 通用:质量门

在 Markdown 或 Skill 修改后、宣布构建完成前,或执行 wiki 健康检查时使用。验证不会自行扩大任务的变更范围。

## 先读

- 归档或移动页面时读取 `knowledge-engine/skills/common/filing-rules.md`。
- 读取被检查页面所属领域的负责 Skill。
- 检查解释性查询或构建时读取 `knowledge-engine/skills/common/reasoning-lenses/SKILL.md`,验证人物视角没有污染中性证据或越过领域边界。

## 内容检查

- 每个非显然判断都能追溯到原始笔记、已标注的对话材料或既有综合页。推断标为 `推断` 或 `待查`。
- 模板只提供结构,不构成生成占位内容的许可。省略无证据支持的项目、表格行、引文和章节。
- 按主要对象归档,并维护有用的双向导航。
- 不要在不同章节机械重复同一证据。
- 使用与领域匹配的语言;人物、城市、系统、状态、事件和人生阶段需要不同类型的判断。
- 当措辞本身是可沉淀证据时,保留用户准确原话。
- 优先做局部、精确的更新,避免宽泛重写。
- 使用人物视角时,执行共享协议的忠实度检查与证据护栏,按成品段落定位结果;本质量门不复制人物规则。协议实质修改时,还须检查实际候选的多视角对照结果,不能以章节齐全代替语义审阅。
- 重大重解释应在日志记录主视角、辅助任务和重跑范围。新增人物必须由动态发现脚本自动出现,下游 Skill 不得复制人物名单。

## 连接来源检查

检查连接目录时读取 `knowledge-engine/skills/build/wiki-build/references/linked-sources.md`。确认原文已解引用、来源链接使用稳定目标、反向导航可发现,且失效来源没有被冒充为有效证据。标签工具不得写入外部原文或系统引用文件。

## 验证模式

### 只读维护

当前目标只检查健康状况、不包含修复时,运行:

```bash
python3 knowledge-engine/tools/validate_wiki_links.py
python3 knowledge-engine/tools/validate_skill_system.py
python3 knowledge-engine/tools/diary_entity_audit.py --check
python3 knowledge-engine/tools/diary_entity_deep_audit.py --check
```

实体检查可能以非零状态报告生成索引陈旧;这是检查结果,不等于必须立即重新生成。

### Markdown 修改后

在仓库根目录运行:

```bash
python3 knowledge-engine/tools/update_obsidian_tags.py
python3 knowledge-engine/tools/update_obsidian_tags.py
python3 knowledge-engine/tools/validate_wiki_links.py
```

第二次标签运行必须报告 `updated=0`;链接验证必须报告 `missing=0 ambiguous=0`。

### Skill 或配套工具修改后

还要运行:

```bash
python3 knowledge-engine/tools/validate_skill_system.py
```

可用时,对每个规范 Skill 运行系统自带的快速验证器。

### 重新生成实体索引

只有任务明确包含摄取/重新生成,或来源数量变化使生成索引陈旧时,才运行:

```bash
python3 knowledge-engine/tools/diary_entity_audit.py --write
python3 knowledge-engine/tools/diary_entity_deep_audit.py --write
```

只读审计绝不使用写入模式。

## 需要人工复核的情况

修改格式错误的 YAML、已改名的原始笔记来源、歧义别名、生成索引数量的意外变化,以及需要用户判断的证据冲突前,先人工复核。

## 完成审计

1. 把目标重述为具体交付物。
2. 将每个请求类别映射到已修改或有意保持不变的产物。
3. 检查代表性文件内容和验证器实际输出。
4. 报告跳过的检查和未解决风险。
5. 只要请求中的要求仍不确定,就继续处理。

验证器通过只能证明它覆盖的约束成立,不能证明用户要求的语义工作已经完成。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall