setup

/hypo-workflow:setup

输出语言规则

📌 输出语言规则： 读取 config.yaml → output.language

• zh-CN / zh：所有用户可见的输出使用中文（PROGRESS、报告、状态提示、错误消息、交互提问）
• en：使用英文
• auto：跟随用户对话语言 内部日志（log.yaml、state.yaml）始终英文。

使用此技能作为插件级设置向导。它配置 Hypo-Workflow 本身，而不是项目本地的 .pipeline/ 工作区。

配置目标

始终使用全局文件：

• 目录：~/.hypo-workflow/
• 配置文件：~/.hypo-workflow/config.yaml

不要从 setup 写入 .pipeline/config.yaml。项目本地配置属于 /hypo-workflow:init 或 /hypo-workflow:plan-generate。

配置优先级

当另一个技能需要运行时默认值时，按此顺序解析值：

1. 项目配置：.pipeline/config.yaml
2. 全局配置：~/.hypo-workflow/config.yaml
3. 内置默认值

重要映射：

• 项目 execution.mode > 全局 execution.default_mode > self
• 项目 execution.subagent_tool > 全局 subagent.provider > auto
• 项目 plan.mode > 全局 plan.default_mode > interactive
• 项目 plan.interaction_depth > 全局 plan.interaction_depth > medium
• 项目 dashboard.enabled > 全局 dashboard.enabled > false
• 项目 dashboard.port > 全局 dashboard.port > 7700
• 项目 output.language > 全局 output.language > zh-CN
• 项目 output.timezone > 全局 output.timezone > Asia/Shanghai
• 项目 watchdog.enabled > 全局 watchdog.enabled > false
• 项目 rules 来自 .pipeline/rules.yaml > 项目 rules.* > 全局 rules.* > extends: recommended

执行流程

1. 如果需要，创建配置目录：
   • mkdir -p ~/.hypo-workflow
2. 检查是否存在全局配置：
   • 如果 ~/.hypo-workflow/config.yaml 不存在，启动首次运行向导
   • 如果存在，读取它，总结当前值，并询问用户是否要修改
3. 检测当前代理平台：
   • 当 Claude 特定标记或环境可见时为 Claude Code
   • 当 Codex 特定标记或环境可见时为 Codex
   • 否则询问用户选择 claude-code 或 codex
4. 询问执行模式：
   • self 推荐给首次用户
   • subagent 启用到另一个代理运行时的委托
5. 如果选择了 subagent 模式，询问：
   • 提供者：codex 或 claude
   • 模型
   • 仅当使用自定义 API 端点时的 Codex base_url
   • 工具可用时的可选连接测试命令
6. 询问 Dashboard 默认值：
   • 默认启用：true 或 false
   • 端口，默认 7700
7. 询问 Plan 模式：
   • interactive 在规划期间暂停确认
   • auto 运行规划阶段，无例行暂停
8. 询问输出默认值：
   • 语言，默认 zh-CN
   • 时区，默认 Asia/Shanghai
9. 询问是否启用 watchdog 默认值：
   • 默认 false
   • 间隔和心跳超时默认 300
10. 询问 Rules 默认值：
    • 预设：recommended、strict 或 minimal
    • 默认 recommended
11. 写入 ~/.hypo-workflow/config.yaml。
12. 打印简洁的配置摘要，并提醒用户项目配置可以覆盖这些值。

首次运行问题

使用简短、具体的提示：

• "当前平台似乎是 <detected>。使用此平台？"
• "默认执行模式：self 还是 subagent？"
• "Subagent 提供者：codex 还是 claude？"
• "Subagent 模型？"
• "自定义 Codex base URL，还是留空？"
• "默认启用 Dashboard？"
• "Dashboard 端口？"
• "Plan 模式：interactive 还是 auto？"
• "交互深度：low、medium 还是 high？"
• "输出语言？"
• "输出时区？"
• "默认启用 Auto Resume watchdog？"
• "历史导入拆分方法？"
• "Rules 预设：recommended、strict 还是 minimal？"

默认值

• agent.platform=claude-code 当在 Claude Code 中运行时，否则为 codex
• agent.model 当可见时应使用当前会话模型
• execution.default_mode=self
• subagent.provider=codex
• subagent.codex.model=gpt-5.4
• subagent.claude.model=claude-sonnet-4-20250514
• dashboard.enabled=true
• dashboard.port=7700
• plan.default_mode=interactive
• plan.interaction_depth=medium
• plan.interactive.min_rounds=3
• plan.interactive.require_explicit_confirm=true
• output.language=zh-CN
• output.timezone=Asia/Shanghai
• watchdog.enabled=false
• watchdog.interval=300
• watchdog.heartbeat_timeout=300
• watchdog.max_retries=5
• watchdog.max_consecutive_milestones=10
• watchdog.notify=true
• history_import.split_method=auto
• history_import.time_gap_threshold=24h
• history_import.max_milestones=20
• compact.auto=true
• compact.progress_recent=15
• compact.state_history_full=1
• compact.log_recent=20
• compact.reports_summary_lines=3
• showcase.language=auto
• showcase.poster.api_key_env=OPENAI_API_KEY
• showcase.poster.size=1024x1536
• showcase.poster.quality=high
• showcase.poster.style=auto
• rules.extends=recommended
• rules.rules={}
• version=8.4.0

配置结构

# Hypo-Workflow global config
# Generated by /hypo-workflow:setup

agent:
  platform: claude-code
  model: claude-sonnet-4-20250514

execution:
  default_mode: self

subagent:
  provider: codex
  codex:
    model: gpt-5.4
    base_url: https://api.vsplab.cn
  claude:
    model: claude-sonnet-4-20250514

dashboard:
  enabled: true
  port: 7700

plan:
  default_mode: interactive
  interaction_depth: medium
  interactive:
    min_rounds: 3
    require_explicit_confirm: true

output:
  language: zh-CN
  timezone: Asia/Shanghai

watchdog:
  enabled: false
  interval: 300
  heartbeat_timeout: 300
  max_retries: 5
  max_consecutive_milestones: 10
  notify: true

history_import:
  split_method: auto
  time_gap_threshold: 24h
  max_milestones: 20
  keyword_patterns:
    - 'feat\(M(\d+)\):'
    - 'M(\d+)-'
    - 'milestone-(\d+)'

compact:
  auto: true
  progress_recent: 15
  state_history_full: 1
  log_recent: 20
  reports_summary_lines: 3

showcase:
  language: auto
  poster:
    api_key_env: OPENAI_API_KEY
    size: "1024x1536"
    quality: high
    style: auto

rules:
  extends: recommended
  rules: {}

version: "8.4.0"
created: "2026-04-26T14:00:00+08:00"
updated: "2026-04-26T14:00:00+08:00"

当使用默认 OpenAI 端点时，省略 subagent.codex.base_url。

连接检查

仅运行与已安装工具匹配的检查：

• Codex 提供者：
  • codex --version
  • 如果需要自定义 API 变量，告诉用户设置 OPENAI_BASE_URL 和 OPENAI_API_KEY
• Claude 提供者：
  • claude --version

如果检查失败，保留配置但在摘要中将提供者标记为未验证。除非用户要求严格检查，否则不要阻止设置。

平台说明

Claude Code 用户：

• 安装/启用 hw 插件并调用命令为 /hw:*；Claude 原生 /resume 与 Hypo /hw:resume 分开
• 通过安装 @openai/codex、设置 OPENAI_API_KEY 并选择 subagent.provider=codex 将 Codex 配置为 subagent
• 除非未来版本明确重新启用，否则 dashboard 不是活动 Claude Code 命令表面的一部分

Codex 用户：

• 调用兼容性命令为 /hw:*
• 将 Codex Subagents 保持在 Codex/GPT 运行时内；不要将 Claude、DeepSeek、Mimo 或其他外部模型路由配置为 Codex Subagent 后端
• 将项目特定覆盖保持在 .pipeline/config.yaml 中

混合模式：

• 对主编排器保持 execution.mode=self
• 使用 step_overrides.<step>.executor=subagent 委托单个步骤
• 仅当 subagent 后端是活动平台原生的或明确记录为非 Codex 交接路径时才选择它

既有配置行为

当配置存在时：

1. 显示平台、默认模式、subagent 提供者/模型、dashboard 和 plan 模式的当前值
2. 询问是否编辑
3. 保留未指定的现有值
4. 更新 updated
5. 保留原始 created 时间戳

Config TUI 编辑

交互式配置编辑必须将全局默认值和项目配置作为单独的目标。首先暂存编辑，显示差异，验证支持的架构字段，并在写入前要求确认。

不要从 setup/config TUI 写入 .pipeline/state.yaml、.pipeline/cycle.yaml 或 .pipeline/rules.yaml。如果影响适配器的值发生变化，告诉用户运行 /hw:sync --light。

参考文件

• references/config-spec.md - 全局/项目配置优先级和字段映射
• config.schema.yaml - 项目架构加上全局配置架构定义
• SKILL.md - 完整系统参考（如果需要更广泛的上下文）