Menu
fleur 的 Git worktree 与多分支协作技能。用于为 Codex/agent 并行任务创建、命名、隔离、验证、合并和清理 worktree；适用于多 agent 同仓库开发、分支实验、并行修复、代码评审和长期任务隔离。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
fleur 的 Dagster 回填操作手册。用于选择 dg launch 命令、资产选择、partition 或 partition-range 参数，以及各数据源的回填模板。
fleur 的 raw 层数据契约、Parquet schema adapter、字段 glossary、dbt sources.yml 和 data_dict 生成工作流。用于新增或修改 pipeline/contracts/datasets、维护 parquet.fields/source/clickhouse_raw 字段事实、维护 external_description_zh/description_zh、运行 fleur-contracts 与 scheduler contract schema 边界校验、修复生成物漂移。
fleur 的 Dagster HTTP 数据源资产开发流程。用于当用户提供远端 HTTP/HTTPS 链接、API endpoint 或接口样例，希望新增或修改 Dagster source asset，将远端数据抓取并写入 S3 Parquet，再通过 contract 驱动同步到 ClickHouse raw 层；覆盖 endpoint profiling、数据契约、scheduler SourceBundle、PyArrow schema 转换、测试和 dg 验收。
fleur 的 dbt staging 前置准备工作流。用于新增或重写 staging model、讨论 staging 清洗规则、为 raw table 设计 canonical 字段、或需要先完成 raw source profiling 再写 stg SQL/YAML/tests 的任务。
fleur 的项目 harness 工程技能。用于把复杂开发、重构、质量治理、需求投递、文档维护和 agent 可读性工作落到仓库内的 docs、架构事实文档、测试、脚本和质量门禁中；尤其适用于需要整理 AGENTS.md、docs/architecture、ADR/RFC/plan/archive/issue/job report、架构边界或长期维护规则的任务。
fleur 前端 CDP 调试流程。用于调试 Racingline 或 app/ 下其他前端时，通过全局 playwright-cli 连接 vnc-mini-desktop 暴露的 Chromium CDP 端点 9222，检查页面截图、DOM snapshot、console、network、响应式布局和交互问题；也用于验证 PLAYWRIGHT_CDP_ENDPOINT、安装/使用官方 Playwright CLI agent skill、或排查 CDP 浏览器连接。
Based on SOC occupation classification
| name | fleur-worktree |
| description | fleur 的 Git worktree 与多分支协作技能。用于为 Codex/agent 并行任务创建、命名、隔离、验证、合并和清理 worktree；适用于多 agent 同仓库开发、分支实验、并行修复、代码评审和长期任务隔离。 |
当同一个 fleur 仓库需要同时推进多个 Codex/agent 任务时，使用这个 skill。目标是一任务一 worktree、一任务一分支、一套明确验证和清理规则，避免 agent 互相踩文件、共享运行时状态或把未完成分支混入主工作区。
git-worktree 文档定义了 add、list、remove、prune 等生命周期命令；清理 worktree 时优先用 Git 命令而不是直接删除目录。fleur/ 内部。主仓库：
/storage/program/fleur
推荐 worktree 根目录：
/storage/program/fleur-worktrees/
命名规则：
<yyyymmdd>-<short-task>codex/<yyyymmdd>-<short-task>-。示例：
/storage/program/fleur-worktrees/20260531-scheduler-runner
branch: codex/20260531-scheduler-runner
在主仓库或任意干净 worktree 中执行：
git status --short
git worktree list
git fetch --all --prune
mkdir -p ../fleur-worktrees
git worktree add -b codex/20260531-topic ../fleur-worktrees/20260531-topic HEAD
如果要基于远端主线创建，先确认默认分支名，再显式指定：
git branch --show-current
git worktree add -b codex/20260531-topic ../fleur-worktrees/20260531-topic origin/main
进入新 worktree 后先同步依赖：
cd ../fleur-worktrees/20260531-topic/pipeline
uv sync --all-packages --all-groups
.env 不提交。需要运行本地命令时，按任务选择：
.env。.env，但必须确认任务不会写入生产或共享状态。DAGSTER_HOME、端口、临时目录或本地数据库 schema。Dagster 运行建议：
dg check defs、ruff、pyright、pytest 可在 feature worktree 内运行。.dagster，并在命令前显式设置 DAGSTER_HOME="$PWD/.dagster"。docs/skills/fleur-dagster-backfill-runbook/SKILL.md 判断是否应该切回主工作区或专用 ops worktree。适合并行：
docs/，另一个只改测试或单个 source bundle。不适合并行：
AGENTS.md、docs/architecture/ 和同一套边界测试。.dagster、数据库 schema、S3 prefix、端口或缓存目录的任务。遇到不适合并行的情况，建立 codex/<topic>-integration 或指定一个 owner worktree，其他分支只作为候选 patch 来源。
当多个分支会互相冲突、共享接口、修改同一架构边界或需要一起验证时，先创建聚合分支，不要让 main 逐个吸收冲突分支。
推荐命名：
codex/integration-<yyyymmdd>-<topic>../fleur-worktrees/integration-<yyyymmdd>-<topic>创建聚合 worktree：
git fetch --all --prune
mkdir -p ../fleur-worktrees
git worktree add -b codex/integration-20260531-topic ../fleur-worktrees/integration-20260531-topic origin/main
在聚合分支按顺序合并候选分支：
cd ../fleur-worktrees/integration-20260531-topic
git merge codex/branch-a
git merge codex/branch-b
git merge codex/branch-c
合并顺序：
聚合分支验证通过后，再让目标主线合并聚合分支：
git checkout main
git merge --no-ff codex/integration-20260531-topic
不要在 main 上逐个解决同一批冲突。main 应只接收已经收敛、可验证、可回滚的聚合结果。
查看所有 worktree：
git worktree list
在 worktree 内确认身份：
pwd
git branch --show-current
git status --short
把分支同步到最新主线：
git fetch --all --prune
git rebase origin/main
如果分支已经推送并协作，优先用 merge 或按团队规则处理 rebase，避免改写别人正在使用的历史。
按改动范围选择最小验证。完整 scheduler 变更使用：
cd pipeline
uv run ruff check scheduler/src scheduler/tests migrate
uv run ruff format scheduler/src scheduler/tests migrate
uv run pyright scheduler/src/scheduler scheduler/tests
uv run pytest scheduler/tests --cov=scheduler/src/scheduler --cov-report=term-missing
cd scheduler
uv run dg check defs
文档-only 变更至少运行：
git diff --check
每个 worktree 的最终汇报必须包含：branch、base、主要改动、验证命令、未验证项、是否有外部副作用。
单个低冲突分支：
git status --short 只包含本任务改动。git fetch --all --prune，再 rebase/merge 最新目标分支。多个冲突分支：
codex/integration-<yyyymmdd>-<topic>。main 的多个 merge 中。分支合并或废弃后：
git worktree list
git worktree remove ../fleur-worktrees/20260531-topic
git worktree prune
git branch -d codex/20260531-topic
如果 worktree 有未提交内容，不要用 -f。先查看：
git -C ../fleur-worktrees/20260531-topic status --short
git -C ../fleur-worktrees/20260531-topic diff --stat
只有用户明确确认废弃时，才允许强制删除。
rm -rf 会留下 stale metadata：优先 git worktree remove，必要时再 git worktree prune。.venv 独立，uv cache 可共享。.env、Dagster home、S3 prefix 或数据库隔离规则。