插件能力

Usora Foundry 把能力沉淀嵌入 Codex 与 CodeBuddy。宿主通过 MCP tools 调用本地 Node.js runtime，用户通常只需要自然语言 prompt。

Prompt Gallery

Initialize my Usora
Show Usora status
Where is my Usora data?
Capture this session
Show recent Activities
Create a Candidate from this reusable pattern
Generate a Skill from an approved Candidate
Evaluate and publish this Skill
Show recent Usora events
Clean old Usora plugin cache

Codex 插件 UI 最多展示三条 default prompt；Usora 把它们用于初始化、捕获 session、清理旧插件缓存。

MCP 工具分组

Hub：hub_init、hub_status、hub_config、hub_doctor、hub_migrate、hub_cleanup、plugin_cache_cleanup。

Activity 与 Pattern：activity_capture、activity_query、activity_get、activity_digest_list、pattern_index、pattern_query、pattern_get。

Candidate：candidate_resolve、candidate_match、candidate_create、candidate_query、candidate_get、candidate_evaluate。

Skill：skill_generate、skill_create、skill_evolve、skill_evaluate、skill_publish、skill_query、skill_get、skill_index。

运行反馈与治理：usage_capture、governance_scan、governance_resolve、skill_graph_validate、telemetry_metrics、context_budget、event_list。

activity_list、candidate_list、skill_list 仍可用，但已 deprecated；新文档和新流程优先使用 query/get。

生命周期能力

• 初始化和检查本地 Hub。
• 按 session 合并 Activity。
• 用 compact digest 查询 Activity，必要时读取完整记录。
• 从 Activity digest 构建 Pattern index。
• 本地解析 Candidate，避免重复创建。
• 从已通过 Candidate 生成 Skill 草稿。
• 评估、发布、PATCH 或治理已有 Skill。
• 记录 Skill 使用结果并计算遥测指标。
• 显式迁移 v1 Hub 到 schema v2。
• 归档已处理 Activities 或清空 Hub。

自动化策略

automation_policy 支持：

• manual_approval：默认策略，生成和发布都需要人审。
• auto_generate_manual_publish：可自动生成草稿，发布仍需人审。
• auto_publish：允许自动发布，适合受控环境。

边界

插件负责 storage、lifecycle、roles 和 state progression。宿主适配与 Hooks 只负责把 session 归一化为 Activity，不实现 Skill 业务逻辑。