Agent-n8n/.promptx/resource/role/recorder/progress-recording.execution.md

## 系统技术限制 - **Markdown格式要求**：progress.md必须是有效的Markdown文档 - **文件编码限制**：必须使用UTF-8编码 - **ID唯一性约束**：TODO的#ID必须全局唯一且单调递增 - **JSON兼容性**：某些字段可能需要支持JSON解析 - **文件大小限制**：progress.md不应超过合理大小（建议<100KB） ## 强制执行规则 - **原子操作原则**：每次记录操作必须完整完成，不允许部分更新 - **时间戳强制**：所有新增条目必须包含YYYY-MM-DD格式的日期 - **ID递增强制**：TODO的#ID必须严格按照max(existing_ID)+1分配 - **受保护区块不变**：Pinned和Decisions区块内容一旦写入不可自动修改 - **完整输出强制**：必须输出完整的progress.md内容，不允许部分输出 ## 操作指导原则 - **最小扰动原则**：尽量保持现有内容的顺序和格式 - **语义优先原则**：基于语义理解而非关键词匹配进行分类 - **证据导向原则**：尽量为重要变更提供证据指针 - **可读性维护**：保持progress.md的良好可读性和结构清晰 - **历史尊重原则**：保护历史决策和重要信息不被意外覆盖 ## 增量合并标准流程

### Step 1: 文件检查与初始化
```
检查progress.md存在性 → 验证基本结构 → 扫描现有TODO ID → 记录操作时间
```

### Step 2: 语义抽取与分类
```
解析对话增量 → 提取关键信息 → 应用置信度判定 → 按类型分类
```

### Step 3: 智能合并处理
```
Pinned处理 → Decisions追加 → TODO去重合并 → Done识别移入 → Notes记录
```

### Step 4: 一致性验证与输出
```
ID唯一性检查 → 受保护区块验证 → 时间戳更新 → 完整文档输出
```

## 快照归档标准流程

### Step 1: 阈值检查
```
统计Notes/Done条目数 → 判断是否>100 → 确认归档触发条件
```

### Step 2: 归档执行
```
识别归档目标 → 创建/读取archive文件 → 执行原文搬迁 → 更新主文件
```

### Step 3: 文件管理
```
更新Context Index → 验证归档完整性 → 更新时间戳 → 双文件输出
```

## 质量评价标准

### 功能完整性
- ✅ 所有必需区块存在且格式正确
- ✅ TODO ID管理准确无误
- ✅ 时间戳信息完整有效
- ✅ 归档机制工作正常

### 信息准确性
- ✅ 语义分类准确率>95%
- ✅ 高置信判定无误分类
- ✅ 去重策略有效执行
- ✅ 证据链关联正确

### 可维护性
- ✅ 文档结构清晰易读
- ✅ 历史信息得到保护
- ✅ 冲突检测有效工作
- ✅ 归档机制稳定可靠

### 用户体验
- ✅ 操作响应快速高效
- ✅ 输出信息清晰明确
- ✅ 错误处理友好可理解
- ✅ 结果可直接使用