---
name: 模板资产可见性规则
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-模板资产可见性规则
asset_kind: hard_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-template-asset-visibility
routes:
  - operation
  - code_change
  - artifact_generation
primary_triggers:
  - 模板资产可见性
  - 内部资产
  - 知识同步
secondary_triggers:
  - sync-templates
  - init
  - visibility
negative_triggers: []
priority: P0
specificity: 5
consumes:
  - template_asset_contract_registry
  - template_init_sync
  - knowledge_index_manager
hard_blocks:
  - internal_asset_leak
  - cross_stack_injection
  - unregistered_asset_sync
fallback: manual_required
required_evidence:
  - visibility_contract
  - sync_manifest
  - runtime_consumption_trace
version: 1.0.0
last_reviewed: '2026-05-26'
status: active
---

# 模板资产可见性规则

## 适用范围

所有 `templates/**` 资产的同步、索引、注入和消费入口。

## 可见性分类

| 可见性 | 说明 |
|--------|------|
| user_project | 用户项目知识，可同步到 `.soloforge/knowledge` |
| soloforge_internal | SoloForge 内部治理，不进入用户项目 |
| adapter_runtime_only | 仅 adapter 运行时消费，不进入用户知识库 |
| scaffold_only | 仅脚手架机制消费，不进入知识索引 |
| global_pattern | 全局工程模式，进入 `~/.soloforge/patterns` |

## 硬规则

- 内部资产不得同步到用户项目。
- 不同技术栈的审查规则不得互相注入。
- 脚手架模板只由脚手架机制消费。
- 全局 patterns 只能作为 `template_guidance`，不得支撑项目事实。
- 用户可见资产不得包含内部施工术语。

## 术语污染扫描

用户可见资产禁止出现: Batch、validate-release、SoloForge Audit: PASS、Mechanism Contract Registry 等内部术语。
