---
name: zero_config_init
when: '项目初始化, 技术栈检测, 零配置, fingerprint'
scope:
  - shared
products:
  - '*'
id: ka-pattern-zero_config_init
asset_kind: pattern
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - 项目初始化
  - 技术栈检测
  - 零配置
  - fingerprint
priority: P2
specificity: 3
version: 1.0.0
last_reviewed: '2026-05-22'
consumes: []
emits: []
secondary_triggers: []
negative_triggers: []
type: pattern
status: active
---

## 决策规则

- detectFingerprint 确定性检测项目技术栈
- 后端检测: pom.xml → Spring Boot、go.mod → Go、Cargo.toml → Rust、build.gradle → Gradle
- 前端检测: package.json → React/Vue/Angular
- generateConfigDraft 根据 fingerprint 生成配置草案
- 检测失败时返回 null，不强制要求配置

## 验收项

- [AC-01] 主流项目类型正确检测
- [AC-02] 无配置文件时返回 null
- [AC-03] 配置草案格式正确
- [AC-04] 多框架共存时分别检测

## 何时使用

advisory: 自动检测是便利功能，可手动配置覆盖

## 是否 hard block

否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。

## 证据要求

- fingerprint 检测测试通过
- 配置草案格式验证通过
-

## 人工确认/降级边界

- 此能力可被开发者决策覆盖
- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
- 降级/禁用需经 sf_capability_update + 人工确认
