bootstrap-skill

name	bootstrap-skill
description	bootstrap castflow install init setup update submodule .castflow bootstrap.py scaffold CLAUDE.md Phase0 language cf_manifest cold start Phase5 skill-creator module skill NOT merge skill meta-spec

bootstrap-skill

作用：装架 CastFlow 到项目 .claude/；project/模块 skill 只在 Phase 5 用 子代理 + skill-creator 写。

铁律（与 SKILL_MEMORY 规则 5 一致）：主 agent 第一条对外消息只能是 Phase 0 语言询问；该步之前禁止扫项目、读除 EXAMPLES 外文件、写盘。

职责：(1) 全量初始化 (2) 核心更新 (3) 给模块 skill 提供流程与模板入口。

要点：装架后项目里有 skill-creator。Phase 5 手话不抄路径表、不枚举四文件名；子代理由 harness（.castflow/...）读规范，产出写到 项目/.claude/skills/<name>/。

必读（读 harness 源，与装架后项目内 .claude/... 为同内容拷贝）
见 ../.castflow/core/skills/SKILL_ITERATION.md → 必读资料栈（创建与冷启动统一）（含 AUTHORING、域 README、.template.md 约定）。

---

快速导航

要查	位置
Phase 0/2/3 话术	EXAMPLES.md#示例-1
cf_manifest、content 占位	EXAMPLES.md#示例-2、#示例-3
模块 skill 对话例	EXAMPLES.md#示例-4
核心更新	EXAMPLES.md#示例-5
域模板（architect/debug/profiler）	../.castflow/bootstrap-assets/skill-templates/<域>.template/ + 各目录 README.md
模块模板 programmer	../.castflow/core/templates/skills/programmer.template/（装架后：项目/.claude/templates/skills/programmer.template/）
Phase 5 手话 + skill-creator	上节链到 SKILL_ITERATION；见下 Phase 5
硬规则	SKILL_MEMORY.md
维护	ITERATION_GUIDE.md

---

运行前置

1. 先读同目录 EXAMPLES.md 示例 1（Phase 0/2/3 话术），再发第一条对外消息。
2. 看 bootstrap-output/cf_manifest.json 是否存在，决定全量 / 复用 / 更新（见 SKILL_MEMORY）。

---

全量初始化

前提：castflow 为 submodule（.castflow/），项目有源码。

• Phase 0：语言菜单，等用户；不落盘。脚本不管语言，见 EXAMPLES。

• Phase 1：扫技术栈、规模、目录。

• Phase 2：debug/profiler 开关（一条消息）。

• Phase 3：命名规范（接在 Phase 2 后，单条消息）。

• Phase 4（仅装架，一条命令）
  python .castflow/bootstrap.py
  同步到项目 .claude/、CLAUDE.md、.claude/templates/；不生成 architect/debug/profiler/programmer-* 正文。
  主命令前需已有 cf_manifest.json 与 content/claude/。
  可选：--claude-md-only / --templates-only。
  验收：装架后项目内存在从 core 同步的元规范、protocols、templates、skill-creator 等（以实际仓库为准）。

• Phase 5（禁止用 bootstrap.py 代写 project skill）

  • 子任务：子代理 + skill-creator，产出 项目/.claude/skills/<name>/。
  • 子代理必读以 SKILL_ITERATION 必读栈 为准（harness 路径在表内、含 .castflow/core 与 bootstrap-assets）。
  • 主 agent 一段话含：目标 skill 名、语言、实值化的栈/目录/{HARNESS} 等；不列四文件名。规则 9：SKILL_MEMORY。

• Phase 6：python .castflow/bootstrap.py --validate，可删 bootstrap-output/。

---

核心更新

触发如「更新核心」。复用 manifest.language → 对比 .castflow/core/ 与已装项目 .claude/ → 合入上游变更、保留项目专属 skill/agent → 更 .claude/templates/。细目：EXAMPLES#示例-5。

---

装架后：模块 skill

意图	模板源（harness）	落点
具体代码模块	../.castflow/core/templates/skills/programmer.template/ + skill-creator	项目/.claude/skills/programmer-<id>-skill/
无域模板	skill-creator + SKILL_ITERATION	同上结构

手话同 Phase 5；不生成 programmer-agent 除非另有流程需要。