Task Finish Contract
Prevent mid-task stalls. Every task must finish with explicit state and evidence.
Problem
Agents often:
- - Stop mid-task without explanation
- Output plans without execution
- Lack clear completion criteria
- Missing evidence artifacts
Workflow
1. State Output (Each Substantial Step)
CODEBLOCK0
2. Completion Proof Format
For tasks with 2+ steps, include:
CODEBLOCK1
3. Anti-Stall Rule
- - Planning-only replies: max 1
- Next reply MUST contain execution evidence
- Never end with "I will now..." without tool result
Executable Completion Criteria
| Criteria | Verification |
|---|
| Goal stated | INLINECODE0 matches |
| Progress tracked |
Select-String "Progress" memory/{date}.md matches |
| Next action defined |
Select-String "Next" memory/{date}.md matches |
| Evidence present | Artifact path/URL exists |
| No unresolved markers |
Select-String "TODO|PENDING|TBD" artifact returns nothing |
Privacy/Safety
- - No sensitive data in completion evidence
- Artifact paths use relative or workspace paths
- No credentials in task logs
Self-Use Trigger
Use when:
- - Starting any multi-step task
- Resuming after interruption
- Handoff to another agent
Finish what you start. Prove it with evidence.任务完成契约
防止任务中途停滞。每个任务必须以明确的状态和证据完成。
问题
智能体经常：
- - 中途停止任务且无解释
- 输出计划但不执行
- 缺乏明确的完成标准
- 缺少证据产物
工作流程
1. 状态输出（每个关键步骤）
markdown
目标：完成状态的定义
进度：已完成的工作
下一步：当前正在执行的具体行动
2. 完成证明格式
对于包含2个及以上步骤的任务，需包含：
markdown
完成检查清单：
证据：
- - 已执行：命令/操作摘要
- 产物：路径/URL/ID
- 已验证：检查命令结果
下一步自主操作：
3. 防停滞规则
- - 仅计划回复：最多1次
- 下一条回复必须包含执行证据
- 不得以我将要...结尾而无工具结果
可执行完成标准
| 标准 | 验证方式 |
|---|
| 目标已陈述 | Select-String Goal memory/{date}.md 匹配 |
| 进度已追踪 |
Select-String Progress memory/{date}.md 匹配 |
| 下一步已定义 | Select-String Next memory/{date}.md 匹配 |
| 证据已提供 | 产物路径/URL存在 |
| 无未解决标记 | Select-String TODO|PENDING|TBD artifact 无返回结果 |
隐私/安全
- - 完成证据中不包含敏感数据
- 产物路径使用相对路径或工作区路径
- 任务日志中不包含凭证信息
自我触发条件
在以下情况使用：
- - 开始任何多步骤任务时
- 中断后恢复时
- 交接给其他智能体时
有始有终。用证据证明。
