score = F·1.0 + D·0.5 + K·1.5 + S·0.5 + E·0.8 + C·2.0 + R·2.5 + U·2.0

CastFlow/
├── README.md                              # 本文件
├── CHANGELOG.md                           # 按版本变更记录
├── LICENSE
├── bootstrap-skill/                       # 【顶层 AI skill】框架初始化器，
│   │                                      # 由 "bootstrap castflow" 触发，驱动装架与 project skill 生成
│   ├── SKILL.md                           #   Phase 0-6 工作流、语言门禁、模板路径
│   ├── EXAMPLES.md                        #   Phase 0/2/3 对外话术、manifest 示例、核心更新对话
│   ├── SKILL_MEMORY.md                    #   规则 1-9（语言门禁、占位符实值化、shell pipe 禁令等）
│   └── ITERATION_GUIDE.md                 #   迭代本 skill 的规范
│
├── .castflow/                             # 框架源码（装架后休眠，仅随 git pull 更新）
│   ├── bootstrap.py                       # 薄包装器，委托到 installer/
│   │
│   ├── installer/                         # 装架引擎（纯 Python 3.6+，零依赖）
│   │   ├── cli.py                         #   CLI 解析 + 主流程编排
│   │   ├── paths.py                       #   项目根 / harness 目录查找（支持 submodule 任意深度）
│   │   ├── backup.py                      #   BackupSession 会话目录式备份 + LRU 轮换
│   │   ├── io_ops.py                      #   safe_write / safe_copy_file / safe_copy_dir
│   │   ├── templates.py                   #   {{PLACEHOLDER}} 替换 + conditional block
│   │   ├── placeholders.py                #   各类占位符字典构建（已精简：安装器不再负责 skill 正文）
│   │   ├── hook_config.py                 #   .cursor/hooks.json 与 .claude/settings.json 幂等合并
│   │   ├── claude_merge.py                #   CLAUDE.md 三策略合并（1=换模板 / 2=保留 / 3=增量）
│   │   ├── validate.py                    #   Skill 规范验证（无 emoji / 无日期 / 无残留占位符 / 字数）
│   │   ├── manifest.py                    #   bootstrap-output/cf_manifest.json 读写
│   │   └── generate.py                    #   Phase A 全量 + Phase A 子集（--claude-md-only / --templates-only）
│   │
│   ├── core/                              # 被装架同步到 .claude/ 的核心内容
│   │   ├── CLAUDE.template.md             #   项目根 CLAUDE.md 的框架段模板（时点定义唯一权威源）
│   │   ├── GLOBAL_SKILL_MEMORY.md         #   跨 skill 运行时协议 1/2/3
│   │   ├── SKILL_ITERATION.md             #   Skill 四文件元规范 + Anchors 格式 + 容量治理
│   │   ├── protocols/
│   │   │   ├── idp-protocol.md            #   Intent Declaration Protocol（T2 按需）
│   │   │   └── validated-protocol.md      #   接受/拒绝信号判定（T3）
│   │   ├── skills/                        # 3 个核心 skill（随装架拷贝到 .claude/skills/）
│   │   │   ├── code-pipeline-skill/       #   多模块协作 9 步工序 + pipeline_protocol
│   │   │   │   └── scripts/
│   │   │   │       └── pipeline_merge.py  #     pipeline Step 3 并行输出聚合
│   │   │   ├── origin-evolve-skill/       #   读 trace、识别模式、生成 Append/Merge/Retire 提议
│   │   │   └── skill-creator/             #   Skill 生成/迭代/eval/benchmark 全套工具链
│   │   ├── agents/                        # code-pipeline 调用的 3 个分析型 agent prompt
│   │   │   ├── requirement-analysis-agent.md
│   │   │   ├── integration-matching-agent.md
│   │   │   └── pipeline-verify-agent.md
│   │   ├── hooks/                         # 生产 Hook 脚本（跨平台）
│   │   │   ├── trace-collector.py         #   编辑事件采集 + 自我修正检测（LRU 50 文件快照）
│   │   │   └── trace-flush.py             #   会话结束 → 五维评分 → trace.md + 四级 compaction
│   │   ├── templates/                     # 装架后供 skill-creator 使用的创作资产
│   │   │   ├── AUTHORING_GUIDE.md         #   Skill 创作元规范（四份域 README 的共享上游）
│   │   │   ├── agents/programmer.template.md
│   │   │   └── skills/programmer.template/   # 模块 skill 四件套模板 + 域 README
│   │   └── traces/                        # 默认阈值与字段契约（分发到 .claude/traces/）
│   │       ├── config/
│   │       │   ├── limits.json            #   compaction 阈值 / 过期天数 / 保护参数
│   │       │   └── hooks.config.json      #   追踪扩展名 / 通用目录段 / 模块推断正则（跨语言适配入口）
│   │       └── README.md                  #   trace 字段契约 + limits / hooks.config 说明
│   │
│   └── bootstrap-assets/                  # 仅在冷启动期间使用的资产（不进 .claude/）
│       └── skill-templates/               #   architect / debug / profiler 的四件套模板 + 域 README
│           ├── architect.template/
│           ├── debug.template/
│           └── profiler.template/
│
└── test/                                  # 框架自身回归测试（不被 bootstrap 分发，176+ tests）
    ├── hooks/                             # 134 tests：评分、compaction、100 天 / 365 天模拟
    ├── bootstrap/                         # 42 tests：installer 包单元测试
    └── origin-evolve/                     # ~7000 次断言：origin-evolve 规范暴力验证

项目根目录/
├── CLAUDE.md                              # 项目全局规则（框架段 + 项目段，增量合并）
├── .claude/
│   ├── skills/
│   │   ├── GLOBAL_SKILL_MEMORY.md         # T1/T2 运行时协议
│   │   ├── SKILL_ITERATION.md             # Skill 四文件元规范
│   │   ├── code-pipeline-skill/           # 【核心】多模块工序
│   │   ├── origin-evolve-skill/           # 【核心】自我进化引擎
│   │   ├── skill-creator/                 # 【核心】Skill 生成工具（含 eval/benchmark）
│   │   ├── architect-skill/               # 【项目级，Phase 5 生成】
│   │   ├── debug-skill/                   # 【可选，Phase 2 勾选才生成】
│   │   ├── profiler-skill/                # 【可选，Phase 2 勾选才生成】
│   │   └── programmer-<模块>-skill/       # 【按需生成】
│   ├── protocols/                         # idp / validated 两份按需协议
│   ├── agents/                            # code-pipeline 调用的 3 个分析 agent
│   ├── hooks/                             # trace-collector.py + trace-flush.py
│   ├── templates/                         # AUTHORING_GUIDE + programmer.template + agent 模板
│   ├── traces/                            # trace.md / weights.json / config/limits.json / config/hooks.config.json
│   ├── rules/                             # origin-evolve 生成的跨模块规则
│   └── settings.json                      # Claude Code hook 配置（增量合并）
├── .cursor/
│   └── hooks.json                         # Cursor hook 配置（增量合并）
└── CastFlow/                              # 框架源码（submodule，进入休眠）

bootstrap castflow

为xx系统生成 skill

帮我在xx系统里加一个批量升级功能

code_pipeline 实现用户交易系统

检测到 5 条 pending 条目含修正信号，建议运行: origin evolve

编辑文件 → trace-collector 记录 path|lines|edits|flags → buffer
会话结束 → trace-flush 读 buffer → 八维评分 → 达标或高价值绕过写 trace.md
AI (IDP) → 填充经验字段：error_cause / fix_approach / user_feedback / lesson

score = F·1.0 + D·0.5 + K·1.5 + S·0.5 + E·0.8 + C·2.0 + R·2.5 + U·2.0    准入 score ≥ 1.5 或 C/R/U 非零

<!-- TRACE status:pending schema:2 -->
timestamp: 2026-05-12T12:58:55Z
mode: rework
type: bugfix
modules: [Building]
skills: [programmer-ui-skill]
score: 4.84
score_breakdown: F=0.33 D=0.25 S=0.08 E=0.48 C=1.2 R=2.5
correction: auto:minor
validated: _
pipeline_run_id: _
error_cause: ObservableList.Add always appends, used it for ordered insert
fix_approach: Changed to Insert(index, item) with bounds check
user_feedback: 不行，列表顺序不对，必须插入到指定位置
lesson: ObservableList ordered insert must use Insert(index) not Add()
<!-- /TRACE -->

Step 1 Read & Triage（schema 门控 + 诊断计数 + P0-P4 排序 + `.trace_lock`）
Step 2 Identify Patterns（六类模式，要求 3+ 证据）
Step 3 Generate Proposals（归属决策树 + Append/Merge/Retire + 容量检查 + Anchors grep 验证）
Step 4 User Approval（逐个，可拒绝并记录 EVOLVE_REJECTION）
Step 5 Write & Mark Processed（原子写 + 审计行替换）
Step 6 Calibrate（可选，单维度 5-10% 微调 weights.json）

编辑 → 采集 → 八维评分 → trace (pending, 含经验字段)
       ↓
提醒 → origin evolve → 模式识别 → 提议 → 审批 → 写入 Skill
                                         ↓
                                   校准 weights.json（可选）
                                         ↓
                                   下次会话：新知识 + 优化模型

.claude/.backups/<YYYY-MM-DD_HH-MM-SS>/
    .claude/
        agents/requirement-analysis-agent.md
        skills/code-pipeline-skill/...