soloforge 1.1.42 → 1.1.44

package/templates/verify//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245.md

@@ -0,0 +1,131 @@
+---
+id: ka-review-rule-接口契约审查规则
+kind: guidance
+title: 接口契约审查
+triggers:
+  - 接口
+  - 契约
+  - API
+  - 版本兼容
+sync_policy: copy_to_project
+status: active
+extra:
+  name: api-contract-rules
+  type: constraint
+  scope:
+    - backend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.2.0
+  last_reviewed: '2026-06-04'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-generic-review
+---
+
+## API-01: Controller 返回 Entity 而非 DTO
+languages: [java]
+pattern: /ResponseEntity<Entity>|ResponseEntity<\s*$/
+severity: warning
+check_type: deterministic
+scope: backend
+description: 禁止直接返回数据库 Entity，必须通过 DTO/VO 转换，防止敏感字段泄漏和结构耦合
+evidence_required:
+  - "扫描结果：含直接返回 Entity 的 Controller 文件路径+行号"
+  - "修复确认：DTO/VO 转换替换证据"
+
+## API-02: 缺少 @Transactional 的写操作
+languages: [java]
+pattern: /@(PostMapping|PutMapping|DeleteMapping|PatchMapping)/
+severity: warning
+check_type: deterministic
+scope: backend
+description: 写操作 Service 方法必须标注 @Transactional(rollbackFor = Exception.class)
+evidence_required:
+  - "扫描结果：含写操作但缺少 @Transactional 的方法文件路径+行号"
+  - "修复确认：事务注解添加证据"
+
+## API-03: 接口缺少权限注解
+languages: [java]
+pattern: /@(PostMapping|PutMapping|DeleteMapping)/
+severity: error
+check_type: deterministic
+scope: backend
+description: 写接口必须有 @PreAuthorize 或 @Secured 注解，禁止裸露写操作
+evidence_required:
+  - "扫描结果：含裸露写操作（无权限注解）的接口文件路径+行号"
+  - "修复确认：权限注解添加证据"
+
+## API-04: 硬编码分页参数
+languages: [通用]
+pattern: /LIMIT\s+\d+|pageSize\s*=\s*\d{4,}/
+severity: warning
+check_type: deterministic
+scope: backend
+description: 分页参数禁止硬编码大数字，pageSize 上限不超过 100
+evidence_required:
+  - "扫描结果：含硬编码分页参数的文件路径+行号"
+  - "修复确认：参数化替换证据"
+
+## API-05: 缺少参数校验注解
+languages: [java]
+pattern: /@RequestBody\s+\w+\s+\w+/
+severity: info
+check_type: deterministic
+scope: backend
+description: "@RequestBody 参数应搭配 @Valid 或 @Validated 注解触发校验"
+evidence_required:
+  - "扫描结果：含未校验 @RequestBody 参数的接口文件路径+行号"
+
+## API-06: 接口路径不符合 RESTful 规范
+languages: [java]
+pattern: /@(Get|Post|Put|Delete)Mapping.*(/get|/query|/add|/update|/delete|/list)/
+severity: info
+check_type: deterministic
+scope: backend
+description: 接口路径应使用资源名词 + HTTP 方法语义，避免 /getUser、/deleteOrder 等动词路径
+evidence_required:
+  - "扫描结果：含非 RESTful 路径的接口文件路径+行号"
+
+## API-07: 接口缺少统一响应包装
+languages: [java]
+pattern: /ResponseEntity<\s*(?!ApiResult|Result|R<)/
+severity: warning
+check_type: deterministic
+scope: backend
+description: 接口返回值必须使用统一响应包装（如 Result<T>），禁止直接返回裸数据或 ResponseEntity
+evidence_required:
+  - "扫描结果：含未包装响应的接口文件路径+行号"
+  - "修复确认：统一响应包装替换证据"
+
+## API-08: 分页接口返回非标准结构
+languages: [java]
+pattern: /Page(?:Info|able)|PageRequest/
+severity: info
+check_type: deterministic
+scope: backend
+description: 分页接口必须返回标准结构（total、list、pageNum、pageSize），禁止自定义分页格式
+evidence_required:
+  - "扫描结果：含非标准分页结构的接口文件路径+行号"
+
+## API-09: 缺少接口版本号
+languages: [java]
+pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(\s*"\/(?!v\d)/
+severity: info
+check_type: deterministic
+scope: backend
+description: API 路径应包含版本号前缀（如 /api/v1/），便于后续接口演进和兼容
+evidence_required:
+  - "扫描结果：含无版本号路径的接口文件路径+行号"
+
+## API-10: 接口缺少 Swagger/OpenAPI 文档注解
+languages: [java]
+pattern: /@(?:Get|Post|Put|Delete)Mapping\s*\(/
+severity: info
+check_type: deterministic
+scope: backend
+description: 接口必须添加 @Operation/@Api 注解，保证 API 文档自动生成
+evidence_required:
+  - "扫描结果：含缺少文档注解的接口文件路径+行号"

package/templates/verify//346/220/234/347/264/242/346/250/241/345/274/217.md

@@ -0,0 +1,47 @@
+---
+id: ka-pattern-search-pattern
+kind: knowledge
+title: 搜索模式
+sync_policy: copy_to_project
+status: active
+extra:
+  name: search-pattern
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-general-pattern
+---
+
+## 决策规则
+- 列表筛选条件超过 3 个必须封装为 SearchRequest 对象，禁止平铺查询参数
+- 动态查询必须使用 MyBatis 动态 SQL 或 JPA Specification，禁止字符串拼接 SQL
+- 模糊搜索（LIKE）必须考虑前缀匹配和索引利用，禁止全表扫描 `%keyword%`
+- 大数据量全文搜索必须使用 Elasticsearch，禁止数据库 LIKE 性能瓶颈
+- 搜索结果必须分页，禁止返回全量匹配结果
+- 搜索条件组合必须明确 AND/OR 语义，禁止歧义
+- 搜索接口响应时间目标 < 200ms，超过时必须优化（索引/缓存/ES）
+- 前端搜索框必须有防抖（建议 300ms），禁止每次按键触发请求
+- 搜索接口必须支持分页，禁止无限制返回结果
+- 搜索结果必须高亮关键词，提升用户定位效率
+- 搜索字段必须建立索引（Elasticsearch mapping 或数据库索引），禁止全表扫描
+- 搜索关键词必须做长度限制和特殊字符过滤，防止恶意查询
+- 搜索结果必须按相关度排序，支持用户自定义排序条件
+
+## 验收项
+- [AC-01] 筛选条件封装为对象
+- [AC-02] 动态查询无 SQL 拼接
+- [AC-03] 搜索结果分页
+- [AC-04] 搜索接口响应 < 200ms
+- [AC-05] 前端搜索有防抖
+- [AC-06] 搜索接口分页
+- [AC-07] 关键词高亮
+- [AC-08] 搜索字段有索引

package/templates/verify//346/225/205/351/232/234/345/244/215/347/233/230.md

@@ -0,0 +1,67 @@
+---
+id: ka-artifact_template-故障复盘模版
+kind: artifact
+title: 故障复盘
+sync_policy: copy_to_project
+status: active
+extra:
+  name: incident-postmortem
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.2.0
+  last_reviewed: '2026-06-07'
+  type: artifact
+  domain: verify
+  stage: verify
+  owner_mechanism: mc-generic-artifact
+---
+
+# 故障复盘报告
+
+## 1. 故障概要
+- **发生时间**：
+- **持续时间**：
+- **影响范围**（用户数/业务量）：
+- **严重程度**：P0/P1
+- **处理人**：
+
+## 2. 时间线
+| 时间 | 事件 | 操作人 |
+|------|------|--------|
+| | 发现问题 | |
+| | 通知干系人 | |
+| | 执行止血 | |
+| | 定位根因 | |
+| | 部署修复 | |
+| | 确认恢复 | |
+
+## 3. 根因分析
+- **直接原因**：
+- **深层原因**（5 Whys）：
+  1. 为什么发生？
+  2. 为什么没被发现？
+  3. 为什么没被阻止？
+  4. 为什么监控没告警？
+  5. 系统性原因是什么？
+
+## 4. 修复过程
+- 止血方案：
+- 最终修复：
+- 修复验证结果：
+
+## 5. 暴露的监控盲区
+| 监控项 | 当前状态 | 改进方案 | 计划完成时间 |
+|--------|---------|---------|------------|
+| | | | |
+
+## 6. 后续改进项
+| 编号 | 改进项 | 类型 | 责任人 | 计划时间 |
+|------|--------|------|--------|---------|
+| | 补监控 | 防复发 | | |
+| | 补测试 | 防复发 | | |
+| | 更新知识条目 | 流程 | | |
+| | 架构优化 | 根治 | | |

package/templates/verify//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264.md

@@ -0,0 +1,37 @@
+---
+id: ka-artifact_template-database-change
+kind: artifact
+title: 数据库变更
+sync_policy: copy_to_project
+status: active
+extra:
+  name: database-change
+  scope:
+    - backend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: artifact
+  domain: verify
+  stage: verify
+  owner_mechanism: mc-artifact-contract
+---
+
+## 验收项
+- [AC-01] migration 脚本有对应回滚脚本 (check: ls U{version}__*.sql {dir})
+- [AC-02] migration 脚本幂等（可重复执行不出错） (check: grep -c 'IF NOT EXISTS\|IF EXISTS' {file})
+- [AC-03] 新增列有默认值或允许 NULL（向前兼容） (check: grep 'ALTER TABLE.*ADD COLUMN' {file} | grep -c 'DEFAULT\|NULL')
+- [AC-04] migration 脚本无业务逻辑（无 SELECT/INSERT/UPDATE 业务数据） (check: grep -ic 'INSERT INTO\|UPDATE.*SET' {file})
+- [AC-05] 大数据量迁移使用分批策略（每批 1000 条） (check: grep -c 'LIMIT.*OFFSET\|BATCH\|分批\|batchSize' {file})
+- [AC-06] 禁止 DROP COLUMN（应标记 deprecated 后续清理） (check: grep -ic 'DROP COLUMN\|DROP TABLE' {file})
+- [AC-07] 新建索引评估对大表的影响（>100 万行使用 ONLINE DDL） (check: grep -c 'ONLINE\|ALGORITHM\|pt-online' {file})
+- [AC-08] 字段命名遵循项目约定（snake_case，无缩写歧义） (check: grep -P '[A-Z]' {file} | grep -v '^\s*--' | head -5)
+- [AC-09] 迁移脚本是否向前兼容（先加列后删列，先加索引后删除旧索引） (check: grep -c 'ADD.*COLUMN\|ADD.*INDEX' {file})
+- [AC-10] 是否有回滚脚本并在测试环境验证通过 (check: ls {dir}/rollback_*.sql {dir}/down_*.sql 2>/dev/null | wc -l)
+- [AC-11] 新增字段是否有默认值（非 NULL 列必须有 DEFAULT） (check: grep 'ADD COLUMN' {file} | grep -cv 'DEFAULT\|NULL')
+- [AC-12] 新增索引是否评估对写入性能的影响（大表需评审） (check: grep -c 'CREATE.*INDEX\|ADD.*INDEX' {file})
+- [AC-13] 大表变更是否使用 ONLINE DDL（避免锁表） (check: grep -c 'ALGORITHM.*INPLACE\|ALGORITHM.*ONLINE\|pt-online\|ONLINE' {file})
+- [AC-14] 数据迁移脚本是否有数据校验步骤（迁移前后行数对比/哈希校验） (check: grep -c 'COUNT(\*)\|checksum\|MD5\|SHA\|校验\|验证' {file})
+- [AC-15] 迁移脚本是否纳入版本控制（Git tracked） (check: git ls-files {file} | wc -l)

package/templates/verify//346/225/260/346/215/256/351/232/220/347/247/201.md

@@ -0,0 +1,46 @@
+---
+id: ka-pattern-data-privacy
+kind: knowledge
+title: 数据隐私
+sync_policy: copy_to_project
+status: active
+extra:
+  name: data-privacy
+  scope:
+    - backend
+    - frontend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-general-pattern
+---
+
+## 决策规则
+- 手机号、身份证号、银行卡号、邮箱、地址等 PII 字段必须脱敏展示（手机号 `138****1234`，身份证 `310***********1234`）
+- 数据库中密码必须 BCrypt 哈希，身份证/银行卡等必须 AES 加密存储，禁止明文
+- 日志中禁止打印完整 PII 字段，必须脱敏或掩码处理
+- 接口响应中敏感字段必须默认脱敏，需要明文的场景必须单独授权接口
+- 数据导出（Excel/CSV）包含 PII 字段时必须有权限控制和操作审计
+- 用户注销/数据删除请求必须级联清理所有关联 PII 数据，包括备份中的软删除标记
+- 数据查询接口禁止支持全量导出 PII 数据，必须分页且有导出上限
+- 前端禁止在 URL 参数、LocalStorage 明文存储敏感信息
+- 个人敏感信息（身份证、手机号、银行卡）存储必须加密或脱敏
+- 数据删除必须支持真删除（不只是软删除标记），满足 GDPR/个人信息保护法要求
+- 用户注销必须清除或匿名化关联个人数据，不能只禁用账号
+- 用户数据导出必须经过审批，导出文件必须加密传输
+
+## 验收项
+- [AC-01] PII 字段展示时有脱敏处理
+- [AC-02] 敏感字段加密存储非明文
+- [AC-03] 日志不含完整 PII 数据
+- [AC-04] 数据导出有权限控制和审计
+- [AC-05] 用户注销关联数据已清理
+- [AC-06] 敏感信息加密存储
+- [AC-07] 接口/日志中敏感信息脱敏
+- [AC-08] 支持数据真删除和匿名化

package/templates/verify//346/226/207/344/273/266/344/270/212/344/274/240.md

@@ -0,0 +1,45 @@
+---
+id: ka-pattern-file-upload
+kind: knowledge
+title: 文件上传
+sync_policy: copy_to_project
+status: active
+extra:
+  name: file-upload
+  scope:
+    - backend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-backend-pattern
+---
+
+## 决策规则
+- 文件必须存储到对象存储（OSS/MinIO/S3），禁止存本地磁盘
+- 必须校验文件类型白名单（禁止 .exe/.sh/.jsp 等）
+- 必须限制文件大小（默认 10MB）
+- 禁止使用原始文件名，必须 UUID 重命名防路径遍历
+- 上传接口必须校验文件 MIME 类型和扩展名双重验证
+- 图片类上传必须校验实际文件头（magic bytes），不能只依赖扩展名
+- 必须配置上传文件总容量限制（单个用户/租户），防止存储滥用
+- 下载链接必须使用签名 URL 或一次性 token，禁止永久公开 URL
+- 禁止上传目录有执行权限（chmod -x），防止上传的脚本被服务器执行
+- 文件上传必须异步处理（先上传再后台扫描），大文件必须支持断点续传
+- 必须记录文件上传/下载审计日志（操作人、时间、文件名、大小）
+
+## 验收项
+- [AC-01] 文件类型白名单校验
+- [AC-02] 文件大小限制（默认 10MB）
+- [AC-03] UUID 重命名文件
+- [AC-04] 存储在对象存储而非本地磁盘
+- [AC-05] 文件头 magic bytes 校验
+- [AC-06] 用户/租户存储容量限制
+- [AC-07] 下载链接签名或一次性 token
+- [AC-08] 上传目录无执行权限
+- [AC-09] 上传/下载审计日志

package/templates/verify//346/227/245/345/277/227.md

@@ -0,0 +1,45 @@
+---
+id: ka-pattern-logging
+kind: knowledge
+title: 日志
+sync_policy: copy_to_project
+status: active
+extra:
+  name: logging
+  scope:
+    - backend
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  type: knowledge
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-backend-pattern
+---
+
+## 决策规则
+- 必须使用 SLF4J + Logback，禁止 System.out.println
+- 所有请求必须有 traceId 贯穿完整链路（MDC Filter）
+- 关键业务操作（创建/修改/删除）必须记录 INFO 日志
+- 禁止日志中打印敏感信息（密码、token、身份证号），敏感字段必须脱敏
+- ERROR 日志必须包含异常堆栈（log.error("msg", e)）
+- 所有新增/修改/删除/审核/审批/发放/冻结/解冻等写操作必须有审计落点
+- 审计至少包含：操作者、操作时间、操作对象、来源入口、关键前后值或结果摘要
+- 关键路径（写操作、状态变更、外部调用、异常捕获）必须有日志，只读查询不得为满足规则而硬加日志
+- 禁止在循环中打印日志（尤其是 DEBUG 级别），防止日志洪泛
+- 异常日志必须包含完整堆栈（log.error("msg", exception)），禁止只打印 getMessage()
+- 生产环境禁止使用 DEBUG/TRACE 级别日志
+
+## 验收项
+- [AC-01] 所有请求有 traceId 贯穿
+- [AC-02] 关键操作记录 INFO 日志
+- [AC-03] 日志不含敏感信息
+- [AC-04] 无 System.out.println
+- [AC-05] 写操作有审计记录（操作者/时间/对象/来源）
+- [AC-06] 关键路径有日志且只读查询无冗余日志
+- [AC-07] 关键操作有审计日志
+- [AC-08] 日志包含 traceId
+- [AC-09] 异常日志包含完整堆栈

package/templates/verify//346/234/254/345/234/260/346/265/217/350/247/210/345/231/250/351/252/214/346/224/266.md

@@ -0,0 +1,94 @@
+---
+id: ka-procedure-本地浏览器验收工作流
+kind: guidance
+title: 本地浏览器验收
+sync_policy: copy_to_project
+status: active
+triggers:
+  - verify
+  - 浏览器验收
+  - Docker 验收
+  - 本地测试
+  - local acceptance
+  - browser test
+  - docker compose
+extra:
+  name: local-browser-acceptance-workflow
+  type: procedure
+  scope:
+    - backend
+    - frontend
+    - infrastructure
+  products:
+    - '*'
+  consumed_contracts:
+    - local_acceptance_contract_entry
+    - coding_readiness_contract_entry
+    - detail_discipline_contract
+  required_sections:
+    - 服务运行规格
+    - 浏览器验收计划
+    - 修复循环策略
+    - 最终访问交付
+  hard_rules:
+    - 有可运行前端/全栈服务时，不得只停在单测、静态检查或审查报告
+    - 项目已有 docker-compose 时必须优先使用
+    - 必须识别 frontend、backend、database、env、ports 和 health checks
+    - 服务启动后必须等待 container healthy、backend health、frontend reachable
+    - >-
+      浏览器验收失败必须 capture → classify → map owner → repair → rebuild → redeploy →
+      rerun
+    - 最终必须给用户本地可访问 URL、运行状态、启动/停止命令
+    - 未给最终本地 URL 不得 delivered
+  acceptance_checks:
+    - requiresLocalAcceptance 判断正确
+    - ServiceRuntimeSpec 已识别所有服务
+    - 浏览器验收计划覆盖任务相关页面和路由
+    - 修复循环策略包含 max_iterations 和 stop_conditions
+    - FinalLocalReviewAccess 包含 frontend_urls/backend_urls/docs_or_swagger_urls
+    - validateFinalAccess passed
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-local-acceptance
+---
+
+## 适用场景
+含前端/全栈服务的项目完成开发后，必须在本地启动服务并通过浏览器验收。适用于有 docker-compose、npm start 或类似启动方式的项目。
+
+## 步骤
+1. **判断是否需要本地验收**: requiresLocalAcceptance 判断
+2. **服务运行规格**:
+   - 识别 frontend、backend、database/cache、env、ports、health checks
+   - docker-compose 优先，否则用项目启动命令
+3. **启动服务**:
+   - 启动所有服务
+   - 等待 container healthy、backend health endpoint、frontend reachable、DB migrated
+   - 检查 logs 无关键错误、port open
+4. **浏览器验收**:
+   - 覆盖任务相关页面、路由、核心交互
+   - API 联动、登录/权限、错误提示、空状态/loading
+   - 检查控制台关键错误和 network 关键失败
+5. **失败处理** (修复循环):
+   - capture failure → classify failure → map owner files
+   - repair within scope → rebuild → redeploy → rerun
+   - retry budget 内循环；超预算 → manual_required
+6. **最终交付**:
+   - 给用户 frontend/backend/docs/swagger 本地 URL
+   - 给用户运行状态、启动/停止命令、测试账号说明、人工查验步骤、未覆盖风险
+
+## 检查点
+- [ ] requiresLocalAcceptance 判断正确
+- [ ] 所有服务启动且 healthy
+- [ ] 浏览器验收覆盖关键页面
+- [ ] 修复循环有预算和停止条件
+- [ ] 最终 URL 交付完整
+
+## 禁止退化
+- 不得只停在单测或审查报告
+- 无 URL 不得 delivered
+- CI 环境无 Docker 时 not_applicable_with_reason，但不能把 runnable 项目判为 delivered
+- retry budget 超出或 scope 不足必须 manual_required

package/templates/verify//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214.md

@@ -0,0 +1,65 @@
+---
+id: ka-checklist-核心工程执行验收清单
+kind: artifact
+title: 核心工程执行
+sync_policy: copy_to_project
+status: active
+extra:
+  name: core-engineering-acceptance
+  type: artifact
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+  owner_mechanism: mc-core-engineering-principles
+---
+
+# 核心工程执行验收清单
+
+## Think Before Coding
+
+- [ ] 所有必要输入是否已明确？不能在缺少关键输入时开始写代码
+- [ ] 写入 scope 是否明确？不能在 scope 不明时修改文件
+- [ ] 外部副作用是否已获授权？
+- [ ] 所有 blocking 级不确定是否已澄清？
+- [ ] 所有 material 级不确定是否已记录为 assumption？
+- [ ] 是否有把未知事实写成确定结论的情况？
+
+## Simplicity First
+
+- [ ] 新增依赖是否必要且已说明理由？
+- [ ] 新增抽象是否必要且已说明理由？
+- [ ] 新增文件数量是否与目标匹配？
+- [ ] 是否有无用户目标支撑的公共 API 扩张？
+- [ ] 是否有绕过已有简单本地模式的复杂方案？
+
+## Surgical Changes
+
+- [ ] 所有修改文件是否在声明的 scope 内？
+- [ ] 是否有与目标无关的修改？
+- [ ] 是否有未经确认回滚用户已有改动的情况？
+- [ ] 是否有大范围格式化掩盖真实变更？
+- [ ] 是否有为通过测试而删除断言/降低覆盖率的情况？
+- [ ] 联动修改是否确实必要（类型/调用方/schema）？
+
+## Goal-Driven Execution
+
+- [ ] 是否有可验证的 GoalDefinition？
+- [ ] success_criteria 是否具体可验证（非"功能正常"）？
+- [ ] 是否有 VerificationPlan？
+- [ ] 验证是否已真实执行？
+- [ ] 验证失败是否已进入 repair_reverify？
+- [ ] 未验证项是否已显式列出？
+- [ ] manual_acceptance_items 是否已列出且未伪装为自动验证？
+
+## 总体判定
+
+- required 原则失败时，整体 VerificationResult 必须 failed
+- 不能用 advisory 结果覆盖 required 失败
+- 不能进入 completed/delivery_ready 如果有 required 原则 failed

package/templates/verify//347/237/245/350/257/206/346/263/250/345/205/245.md

@@ -0,0 +1,38 @@
+---
+id: ka-checklist-知识注入验收清单
+kind: artifact
+title: 知识注入
+sync_policy: copy_to_project
+status: retired
+extra:
+  name: knowledge-injection-acceptance
+  type: artifact
+  scope:
+    - '*'
+  products:
+    - '*'
+  lifecycle_status: active
+  version: 1.1.0
+  last_reviewed: '2026-06-01'
+  domain: verify
+  verification_layer: L2
+  stage: verify
+---
+
+# 知识注入验收清单
+
+## 必检项
+
+- [ ] KnowledgeInjectionReport 已生成
+- [ ] indexed 数量 + excluded 数量 = 总知识数量
+- [ ] injected_required 列表无 draft/quarantine/deprecated 状态知识
+- [ ] missing_required_knowledge 列表为空或已处理
+- [ ] conflicts 列表已审查
+- [ ] budget 使用率在合理范围内
+
+## 禁止项
+
+- [ ] draft 知识出现在 injected 列表中
+- [ ] required 资产缺失但无报错
+- [ ] 无 KnowledgeInjectionReport
+- [ ] code_change 路由注入了 source_extraction 模版