alice-goal

Files (3)

• SKILL.md
• openai.yaml · agents/
• alice-goal.sh · scripts/

SKILL.md (first lines)

# Alice Goal

在当前 work session 中设定并自动迭代执行的长期目标。

## 命令

- `scripts/alice-goal.sh get` - 查看当前目标
- `scripts/alice-goal.sh create '{"objective":"为项目补充单元测试","deadline_in":"48h"}'` - 创建目标（deadline_in 可选，默认 48h）
- `scripts/alice-goal.sh delay <duration> <reason>` - **每一轮对话必须调用**，设置下一轮迭代的延迟唤醒时间
- `scripts/alice-goal.sh pause` - 暂停
- `scripts/alice-goal.sh resume` - 恢复
- `scripts/alice-goal.sh complete` - 仅限 `audit_completion` subagent 调用，Main Agent 在任何情况下都不得直接调用此命令
- `scripts/alice-goal.sh clear` - 删除目标

## 核心机制

### 自动循环原理

每次 Main Agent（即本次设定 `alice-goal` 的 Agent）迭代完成后，系统通过 `delay` 机制调度下一次唤醒。Main Agent **必须在每轮迭代结尾显式调用 `alice-goal delay`** 来声明下一次唤醒时间。不调用 delay 的迭代视为违规。

**三个合法出口**（每轮迭代必须且只能选择其一）：

| 出口 | 调用 | 效果 |
|------|------|------|
| 立即继续 | `alice-goal delay 0s "继续推进 <具体任务>"` | 当前有明确工作可做，立即进入下一轮 |
| 延迟等待 | `alice-goal delay 17m "等待 <具体外部资源>"` | 当前在等待外部资源就绪，延迟后再唤醒检查 |
| 目标完成 | 由 `audit_completion` 调用 `alice-goal complete` | 审计确认目标已全部完成 |

### delay 命令详细说明

`alice-goal delay <duration> <reason>` 设置目标下一次被引擎唤醒的时间。

**核心约束：delay 只能用于等待外部资源。**

没有需要等待的外部资源（CI、构建、部署、数据文件、API 配额、第三方服务等），就**必须用 `0s` 立即继续推进**，或触发僵局重新规划。严禁用正延迟来偷懒或躲避工作。

**参数**：

- `duration`（必填）：Go duration 格式的相对延迟，类型为字符串
  - 格式：`"Ns"`, `"Nm"`, 可组合如 `"1m30s"`
  - 范围：`"0s"` 或 `1m ~ 30m`（引擎强制校验）
  - `"0s"` = 立即进入下一轮迭代（当前有明确工作可推进）
  - 最小正延迟为 `"1m"`，最大延迟为 `"30m"`（不在此范围内的 duration 会被拒绝）
- `reason`（必填）：用引号括起来的一句话，**必须明确写明正在等待的具体外部资源**
  - `"0s"` 时必须说明下一步具体要做什么
  - 正延迟时 **必须** 写明等待的具体外部资源名称（如 CI pipeline、GitHub PR、构建系统、数据文件路径、API 端点等）

**选取延迟的指导**：

- **等待 CI/构建/部署完成** → `"7m"` ~ `"17m"`（选 `"8m"` / `"13m"` / `"17m"` 等非整点值）
- **等待 code review / PR 状态更新** → `"13m"` ~ `"27m"`（选 `"13m"` / `"19m"` / `"27m"` 等非整点值）
- **等待外部资源就绪（数据文件、权限、API 配额等）** → `"7m"` ~ `"19m"`（选 `"8m"` / `"13m"` / `"19m"` 等）
- **严禁选取的值**：
  - 不要选 `"5m"` `"10m"` `"15m"` `"20m"` `"30m"` 等整数边界值——选临近的非整点值如 `"7m"` `"13m"` `"17m"` `"23m"` `"28m"`
  - 不要选 `< 1m` 的正值（引擎直接拒绝）
  - 不要选 `> 30m` 的值（引擎直接拒绝）
- **严禁以下场景使用正延迟**：
  - "当前无实质工作可推进" → 触发僵局重新规划，而不是设一个延迟混过去
  - "需要用户确认或输入" → 用户可能不会回复，设正延迟等于空转。此时应设 `0s` 并明确说明需要用户输入，或暂停目标
  - "审计确认目标已完成" → 必须走 audit_completion → alice-goal complete 流程

**reason 质量要求**：

- reason **必须**包含正在等待的**具体外部资源名称**
- 好的 reason：`"waiting for PR #225 CI checks to complete on GitHub"`, `"waiting for data-team CSV file at /data/export/output.csv"`, `"waiting for Docker build on Jenkins pipeline #4421"`
- 坏的 reason：`"waiting"`, `"继续"`, `"delay"`, `"等一下"`, `"没什么可做的"`—没有指明具体外部资源，会被日志标记为低质量 delay。尤其 `"没什么可做的"` 而设正延迟是严重违规

### 严格审计流程

Main Agent 严禁自行执行审计步骤或直接调用 `alice-goal complete`。所有审计和完成操作必须通过调用 subagent 完成，约定这个负责执行严格审计步骤的 subagent 叫做 `audit_completion`。

1. 必须调用 `audit_completion` subagent 完成审计 — Main Agent 严禁自行执行任何审计步骤（列清单、核证据、判断缺口等），也严禁以任何形式调用 `alice-goal complete`。
2. `audit_completion` 必须执行的审计步骤：
   - 明确目标为具体交付物/成功标准
   - 列出检查清单（每个要求对应具体证据）
   - 逐项核对真实证据（文件/输出/PR等，不凭记忆或猜测）
   - 警惕假信号（测试通过/代码量大≠完成，必须覆盖每一项要求）
   - 找出缺口（任何缺失、薄弱或未覆盖即为未完成）
   - 不依赖意图、半成品、耗时等
   - 仅当所有要求满足且无遗留工作时，方可进入下一步
3. 标记完成（仅限 `audit_completion`）：
   - 只有 `audit_completion` 有权调用 `alice-goal complete`。成功后向用户报告总耗时。
   - 绝对禁止因超时或 Main Agent 打算停止而标记完成。
   - 绝对禁止在当前执行回合标记完成；必须在下一独立回合中由 `audit_completion` 重新完成审计后才可调用。
4. 违规后果：Main Agent 若自行调用 `complete`、自行审计或绕过 `audit_completion`，视为严重违规，必须立即停止输出并进入下一次循环。

### 实用规则

- **delay 强制且仅限外部资源**：Main Agent 在每轮迭代结束前**必须调用 `alice-goal delay`**。正延迟**只能**用于等待具体的外部资源。没有外部资源需要等待时，必须用 `0s` 继续推进或触发僵局重新规划。不调用 delay 或用正延迟偷懒均为违规。
- 本轮迭代内如有需要等待的同步操作（如轮询 API 状态），仍在当前迭代内用 `sleep` 阻塞。但**迭代之间的等待**必须用 `alice-goal delay`，将调度权交还给引擎。不要在迭代内用长时间 `sleep` 来模拟跨迭代延迟。
- 单回合单步：Main Agent 每回合只推进一项具体任务（通常是调用一个 subagent 或一个原子操作），完成后立即退出。
- 极限并行与结果排序：
   - 任何可拆分的独立子任务必须分给独立 subagent 并行执行。
   - 汇总所有 subagent 结果时，严格按照结果对完成目标的重要性降序输出：最重要结果放在最前面详细描述，次要结果可缩减篇幅或后置。不要因为每个 subagent 都完成了任务就平均用力。
- 僵局重新规划：出现以下情况之一时，Main Agent 必须立即停止当前行动并执行重新规划：依赖缺失、任务无法拆分、连续多回合无实质推进、审计缺口不明确、外部接口不可用等。重新规划步骤：分析目标缺口→调整策略→重新拆解任务序列→在本回合或下一回合启动新的并行 subagent 群。严禁原地重试、空转或重复失败动作。

From Alice-space/alice, MIT.

More from Alice-space/alice