用途：在共享仓库中协调多智能体或跨会话的单人工作，处理冲突规避、交接、验证债务、持久记忆/wiki 与 hooks 自动化。
主要能力：提供生命周期流程 BEFORE/READ+REASON → DURING/DO → AFTER/VERIFY → LEARN? → CLEAN? → PROJECT?。功能覆盖：定位与状态（attend、workspace status、query、session capture、agent registry）；计划与任务（依赖、就绪、认领、心跳、提交、释放）；工作与文件（start/touch/end/list/show）；独占工作与验证（work start --exclusive、锁恢复、mark/audit）；信号与细化（signal publish/list/reply/ack/resolve/prune、refinement get/set/delete）；记忆（recall/record/forget/archive/restore，用 --supersedes 纠正）；反思与评审（reflect/review/export harness）；知识/wiki（docs/staleness、wiki sync、projections）；hooks/宿主（install/check/remove/run，支持 Claude/Codex/Cursor/Pi）；维护与契约（maintenance、schema 命令）。
使用方式：本地运行 node packages/octocode-awareness/out/octocode-awareness.js，或安装后使用 npx @octocodeai/octocode-awareness。需按智能体/会话设置 OCTOCODE_AGENT_ID。宿主支持委派时，将常规确定性 Awareness CLI 读写与维护批量合并为一个阶段，使用最小能力的低成本智能体（如 Haiku 或 Composer 2.5），提供已定范围、要求 --compact，回执上限 512 字节；负责人保留破坏性审批、冲突处理、记忆真伪判断与验证。宿主无法委派时才直接运行。典型循环：attend → work start → edit/check → work end → verify mark → verify audit，必要时加 --exclusive；lock wait/prune 用于恢复。
适用场景：共享仓库中的多智能体协作、跨会话单人开发、需要冲突规避与交接、验证债务跟踪、持久记忆与 wiki 同步、hooks 自动化确定性边界。
限制：hooks 不选择计划、锁、成功、学习、清理或投影；过期不代表成功；普通重叠允许但不得绕过冲突；记忆与 .octocode/ 仅作线索，禁止手工编辑 .octocode/；安装时 Claude 使用 frontmatter，不要安装重复的项目 hooks；重建用 yarn workspace @octocodeai/octocode-awareness build，不要编辑镜像。部分细节（如具体收费、平台支持范围）暂未提供。