team-feature-flag

Preamble (run first)

_UPD=$(~/.claude/skills/cto-fleet/bin/cto-fleet-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true

If output shows UPGRADE_AVAILABLE <old> <new>: read ~/.claude/skills/cto-fleet/cto-fleet-upgrade/SKILL.md and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). If JUST_UPGRADED <from> <to>: tell user "Running cto-fleet v{to} (just updated!)" and continue.

参数解析：从 $ARGUMENTS 中检测以下标志：

• --auto：完全自主模式（不询问用户任何问题，全程自动决策）
• --once：单轮确认模式（将所有需要确认的问题合并为一轮提问，确认后全程自动执行）
• --action=audit|cleanup|strategy：执行动作（可选，默认 audit 审计模式）
  • audit：仅扫描和分析，输出 flag 清单和健康度报告
  • cleanup：在 audit 基础上生成清理代码（移除过期 flag）
  • strategy：在 audit 基础上输出发布策略建议（渐进式发布/灰度方案）
• --provider=launchdarkly|unleash|custom|auto：Feature Flag 提供商（默认 auto 自动检测）
• --lang=zh|en：输出语言（默认 zh 中文）

解析后将标志从管理需求描述中移除。

模式	用户确认范围	条件节点处理
标准模式（默认）	扫描范围确认 + 清理方案确认 + 最终报告确认	正常询问用户
单轮确认模式（--once）	仅最终报告确认	自动决策 + 收尾汇总
完全自主模式（--auto）	不询问用户	全部自动决策，收尾汇总所有决策

单轮确认模式下自动决策规则：

• flag 提供商检测不确定 → scanner 列出所有可能的 provider，选择匹配度最高的
• 两位 analyzer 对同一 flag 的状态评估差异过大（如一方定为"可清理"、另一方定为"活跃"） → 不可跳过，必须暂停问用户（熔断机制）
• 需要清理的 flag 超过 20 个 → 不可跳过，必须暂停问用户（熔断机制）
• 无法确定 flag 是否在生产环境生效 → analyzer 标注"状态未知，建议人工确认"，不阻塞流程
• 发现嵌套 flag（flag 依赖另一个 flag） → analyzer 标注依赖关系，清理时优先处理被依赖的 flag

完全自主模式下：所有节点均自动决策，不询问用户。熔断机制仍然生效（状态评估差异过大、待清理 flag 超过 20 个时仍必须暂停问用户）。

使用 TeamCreate 创建 team（名称格式 team-feature-flag-{YYYYMMDD-HHmmss}，如 team-feature-flag-20260308-143022，避免多次调用冲突），你作为 team lead 按以下流程协调。

文件交接规范（File-Based Handoff）

所有 agent 间传递详细报告时，必须采用文件交接模式（防止上下文溢出触发 20MB 限制）：

1. 写入文件：将完整报告写入团队工作目录：
   • 目录路径：/tmp/{team-name}/（team lead 在 TeamCreate 后执行 mkdir -p /tmp/{team-name} && chmod 700 /tmp/{team-name}）
   • 单个文件 ≤ 2000 行；超大报告拆分为 summary + details 文件
2. 发送引用：通过 SendMessage 仅发送（≤500 字符）：
   • 文件路径（1 行）
   • 关键摘要（含核心指标/发现/评分）
3. 按需读取：接收方使用 Read 按需读取文件，发送方不内联完整内容
4. 路径转发：team lead 转发报告时只转发文件路径 + 摘要，不 Read 后再 SendMessage
5. 遵从校验：team lead 收到超 1000 字符且不含 /tmp/team- 路径前缀的消息时，要求 agent 以文件交接模式重发