Improvement Goal
【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode
Objective
{specific objective}
Target Metric
- Metric name: {name}
- Target value: {value}
- Direction: higher_is_better | lower_is_better
Scope
- In scope: {files, modules}
- Out of scope: {exclusions}
Milestones (optional)
| Milestone | Target | Strategy Focus |
|---|
Experiment Ideas (optional)
{ideas from interview}
各字段的实战含义: - **Objective**:一句话说清"要改进什么"。后续 planner 的 hypothesis 必须能回应它; - **Target Metric**:三元组(metric name / target value / direction)。其中 `direction` 只有两个合法取值 `higher_is_better`(越大越好)或 `lower_is_better`(越小越好),与 `settings.json` 中的 `benchmark_direction` 对应,直接决定 tournament 阶段的排序与回归判定方向; - **Scope**:显式圈定 in/out 边界。`in scope` 告诉 researcher/planner 可以动哪些文件模块;`out of scope` 防止改进循环越界改造不该碰的代码; - **Milestones(可选)**:表格形式,模板预置了 M1(quick wins / low-hanging fruit)与 M2(moderate improvements)两行的示例语义,用于把长目标拆成渐进里程碑; - **Experiment Ideas(可选)**:记录访谈过程中用户提到的实验想法,供后续循环直接消费(SKILL.md 中 Step 3 会读取 `idea.md` 并快照给 planner)。 ### 与 settings.json 的字段对应关系 goal.md 不是孤立文档。对照 [skills/self-improve/templates/settings.json](https://link.gitcode.com/i/dc92b9294f34f66f9f7488bb23f71a34) 可以看到: ```json { "benchmark_command": "", "benchmark_format": "json", "benchmark_direction": "higher_is_better", "max_iterations": 50, "plateau_threshold": 0.01, "plateau_window": 3, "target_value": null, "primary_metric": "primary", "regression_threshold": 0.05, "circuit_breaker_threshold": 3, "auto_push": false, "auto_pr": false }目标澄清阶段至少会写入benchmark_direction与target_value两个字段(默认模板中target_value为null,benchmark_direction默认为higher_is_better)。而goal_slug则由目标 Objective 派生(转小写、下划线连接),持久化在 agent-settings.json 的goal_slug字段中,用于跨会话保持一致。
六、目标如何驱动下游:goal_slug 与数据契约
git 分支命名
goal_slug不是摆设。SKILL.md 的 Setup Phase 与 Git Strategy 明确用它构建改进分支:
git -C {repo_path} checkout -b improve/{goal_slug} {target_branch}即:澄清出的目标直接决定 git 改进分支名improve/{goal_slug};后续每次迭代的实验分支experiment/round_{n}_executor_{id}都从该改进分支派生,赢家合并回improve/{goal_slug}(--no-ff),输家以archive/round_{n}_executor_{id}打标签后删除。这也是为什么目标必须"可写成 slug"——它同时是仓库里可见的身份标识。
Goal Phase 契约
data_contracts.md 的第 12 节为 goal.md 预留了## Phases扩展区:
## Phases | Phase | Focus | Sub-Score Targets | Status | |-------|-------|-------------------|--------| | phase_1 | Primary dimension | dim_a >= 90.0 | active | | phase_2 | Secondary dimension | dim_b <= 50.0 | pending |【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考