Menu
fleur 的 Git worktree 与多分支协作技能。用于为 Codex/agent 并行任务创建、命名、隔离、验证、合并和清理 worktree；适用于多 agent 同仓库开发、分支实验、并行修复、代码评审和长期任务隔离。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
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 浏览器连接。
Baseado na classificação ocupacional SOC
| 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 或数据库隔离规则。