Loop Engineering 与 OrgReOrg 落地¶
概念关系¶
Prompt Engineering 关注单次指令如何写。
Context Engineering 关注给模型什么上下文、如何组织上下文、如何控制上下文窗口。
Harness Engineering 关注 runtime、工具、权限、workflow、审计、评测等外部工程系统。
Loop Engineering 关注 Agent 在真实任务中如何循环工作：什么时候触发、如何保存状态、如何规划、如何行动、如何验证、如何持久化、如何通知人。
Loop Engineering 更像近期围绕 Claude Code、Codex 和其他 agentic coding / agentic workflow 实践形成的工程范式，不应写成 Anthropic 官方正式产品名。它对 OrgReOrg 的价值在于：把“多轮 Agent 行为”从隐式聊天过程变成可设计、可验证、可审计的业务循环。
Loop 的组成¶
```text Trigger 谁或什么事件触发 loop
State 当前任务、权限、上下文、历史、外部对象状态
Plan Agent 拆解步骤、选择工具、判断风险
Act 调用搜索、Connector、MCP 工具或请求人工输入
Verify 校验结果、证据、权限、测试、业务规则
Persist 写入知识库、任务状态、审计日志、缓存或索引
Decide 判断继续、暂停、升级、完成或失败
Notify 通过 Web、企业微信、飞书或邮件通知相关人 ```
为什么需要 Loop Engineering¶
组织任务很少是一问一答。
例如“帮我判断这个客户项目能否本周交付”需要：
- 查 CRM 的客户承诺。
- 查项目管理系统的任务状态。
- 查 GitHub PR 和 CI。
- 查财务或合同中的交付条款。
- 查 BI 或工单中的上线风险。
- 向负责人确认异常。
- 输出判断、证据和后续动作。
这不是一个 prompt 能解决的问题，而是一个跨系统、跨权限、跨角色的 loop。
Search Loop¶
text
Trigger: 用户问题或 workflow 需要知识
State: 用户权限、任务范围、已读证据
Plan: 拆分关键词和数据源
Act: BM25 / Vector / Rerank / get_document
Verify: 证据是否足够、是否冲突、是否过期
Persist: 检索记录、引用、知识缺口
Decide: 继续检索、请求授权或生成答案
Notify: 返回带证据的回答
Search Loop 是 OrgReOrg 第一阶段最重要的 loop。
Collection Loop¶
text
Trigger: 搜索缺口、权限不足、系统缺失
State: 缺口类型、候选系统、候选负责人
Plan: 确定请求资料还是请求 Connector 授权
Act: 通过企业微信/飞书/Web 发起请求
Verify: 检查资料质量、权限范围和来源
Persist: 写入索引、知识库、connector registry
Decide: 关闭缺口或继续追问
Notify: 通知请求人和负责人
Collection Loop 的核心是跨部门业务系统的信息源接入与主动收集。
Permission Loop¶
text
Trigger: 工具调用、搜索、上下文注入或写入动作
State: 用户、角色、部门、项目、对象、动作等级
Plan: 判断是否允许、是否脱敏、是否审批
Act: policy check / approval request / deny
Verify: 源系统权限和 OrgReOrg 策略一致
Persist: 审计记录和授权记录
Decide: 执行、等待、拒绝或升级
Notify: 给用户和审批人明确说明
Permission Loop 确保 Agent 不因上下文能力增强而越权。
Knowledge Maintenance Loop¶
text
Trigger: 文档变更、系统更新、定期巡检、评测失败
State: 文档版本、索引状态、引用热度、过期标记
Plan: 判断重建索引、归档、更新或人工 review
Act: 解析、清洗、入库、生成变更摘要
Verify: MkDocs build、搜索抽样、链接检查
Persist: 更新 docs/vault/index/audit
Decide: 发布、退回或创建维护任务
Notify: 通知 owner 和团队
这条 loop 让知识库不是静态文档，而是持续更新的组织知识系统。
与 Claude Code 实践的关系¶
Claude Code hooks、MCP 工具、skills、subagents 和长任务 session 都提示了同一个方向：Agent 的能力来自模型与外部 loop 的组合。
OrgReOrg 应把这些能力工程化：
- Hooks 用于生命周期事件、权限检查和审计。
- MCP 用于稳定工具边界。
- Skills 用于任务模板和领域操作说明。
- Sub-agents 用于分工处理搜索、审计、评测和专业任务。
- Memory / Context 用于维护跨任务上下文，但必须受权限视图控制。
参考资料：
- Claude Code Hooks 文档：https://docs.anthropic.com/en/docs/claude-code/hooks
- Anthropic MCP Connector 文档：https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector
- Claude API 概览：https://docs.anthropic.com/claude/reference/getting-started-with-the-api