Skip to content

v0.1.4 - 冻结目标机制

Choose a tag to compare

View all tags
@congwa congwa released this 03 Apr 06:09
v0.1.4
9a7283c

核心亮点

规划型任务支持"冻结目标 + 可变规划"：规划文件可以修正，但冻结目标不会变。

⚠️ 重要：prompt.md 必须包含规划章节

prompt.md 必须明确说明当前状态、从哪里开始、做什么任务，否则大模型会自己幻想。

推荐格式：

# 任务规划

## 目标
- 目标 A
- 目标 B
- 目标 C

## 执行步骤
- 这部分允许继续修正
- 可以调整顺序
- 可以补充过程说明

## 当前推进状态与建议施工顺序

- 已完成：
  - 第 12 章 `12-REPL状态流转.md` 
  - ...

- 待写：
  - 第 22-26 章：继续写会话长期化阶段...
  - ...

从待写开始写

关键点：

  • 已完成 列表：让模型知道哪些不用重复
  • 待写 列表：让模型知道接下来要做什么
  • 从待写开始写 这句很重要：明确指示起点

新增：冻结目标机制

# 显式传冻结目标（推荐）
codex-autoresearch \
  --prompt-file ./prompt.md \
  --frozen-goals-text "- 完成接口文档
- 完成 CLI 示例
- 更新 README"

这时：

  • prompt.md 仍然可以继续修正
  • 冻结目标以 --frozen-goals-text 为准
  • 后续 resume 和完成判定都围绕这份冻结目标工作

新增状态文件

文件 作用
goal-contract.md 冻结目标契约
goal-manifest.json 结构化冻结目标清单
working-plan.latest.md 当前最新规划文件快照
plan-revisions.jsonl 规划文件修订记录

安装

# 从 npm 全局安装（推荐）
npm install -g codex-autoresearch
codex-autoresearch --version

使用方式

1. 规划文件驱动（推荐）

codex-autoresearch --prompt-file ./prompt.md

2. 带冻结目标

codex-autoresearch \
  --prompt-file ./prompt.md \
  --frozen-goals-text "- 目标1
- 目标2"

3. 直接传任务文本

codex-autoresearch "请检查当前仓库 TODO，补齐缺失测试并更新 README"

4. 常用命令

codex-autoresearch --version          # 查看版本
codex-autoresearch --help             # 查看帮助
codex-autoresearch session resume --last   # 恢复最近任务
codex-autoresearch session status --last   # 查看最近任务状态

Completion Protocol

对于规划型任务，要求在最终两行之前输出：

<completion_report>
- [x] 冻结目标 1
- [x] 冻结目标 2
</completion_report>

只有同时满足下面条件才会标记为 completed：

  • 最终两行匹配 completion protocol
  • 没有阻断型 MCP/tool 失败
  • completion_report 覆盖全部冻结目标

完整更新日志

详见 CHANGELOG.md

Assets 2
Loading