## 系统技术限制 - **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% - ✅ 高置信判定无误分类 - ✅ 去重策略有效执行 - ✅ 证据链关联正确 ### 可维护性 - ✅ 文档结构清晰易读 - ✅ 历史信息得到保护 - ✅ 冲突检测有效工作 - ✅ 归档机制稳定可靠 ### 用户体验 - ✅ 操作响应快速高效 - ✅ 输出信息清晰明确 - ✅ 错误处理友好可理解 - ✅ 结果可直接使用