核心概念

Usora 的核心不是“聊天记录归档”，而是把真实工作压缩成可审阅、可复用、可演进的能力资产。

Activity

一次真实工作活动。它保存任务、摘要、关键点、方法、技术、结果和 outcome。activity_capture 支持按 session_id 合并，避免同一 task 被拆成一堆碎片。

Activity 默认用 activity_query 返回 digest；只有 digest 不够时才用 activity_get 读取完整记录。

Pattern

Pattern 是从 Activity digest 中建立的本地模式索引。pattern_index 默认增量处理新 Activity，pattern_query 用来找已经出现多次、值得进入 Candidate 流程的模式。

Candidate

Candidate 是一个可复用模式提案。candidate_resolve 会先做本地重复检查：能匹配现有 Candidate 或 Skill 就复用；证据不足就丢弃；达到阈值才创建新 Candidate。

Candidate 需要 Maintainer 评估为 pass 后，才适合作为 Skill 生成或演进的来源。

Skill Draft 与 Evaluation

Skill Draft 是 SKILL.md 草稿。skill_generate 从通过评估的 Candidate 生成确定性草稿；skill_evaluate 记录 pass/fail；skill_publish 按配置的 Maintainer 原地发布当前 Skill。

已有 Skill 不一定要新增一份。skill_evolve 会优先 PATCH 相似 Skill，也支持 CREATE、NOOP、SPLIT、MERGE 这类决策。

Maintainer 与 Hub

Maintainer 是质量控制角色，默认是 codex。Hub 是本地数据目录，包含 Activities、Patterns、Candidates、Skills、usage、indexes、events、backups 等记录。

hub_status 返回 Hub 路径、配置、计数、schema 迁移状态和下一步建议。hub_doctor 做轻量健康检查。

状态机

推荐路径是：

Capture Activity -> Index Pattern -> Resolve Candidate -> Evaluate Candidate -> Generate/Evolve Skill -> Evaluate Skill -> Publish

状态表示本地生命周期进度，不代表自动云同步。Usora 当前没有云端服务。