MOS/mos_v3/mos_core

mos_core/README.md

MOS v3 是面向 agent 会话的本地文件型记忆操作框架。它保留规则、策略、模板、本地工具、静态数据库/索引流程，不包含具体用户项目记忆。

如果只想快速理解整体结构，先读 ARCHITECTURE_AND_FLOW.md。

1. 核心原则

1. 原始历史不应长期塞进聊天上下文，应作为可回源资料保存。
2. 长期结论写入 memory_cards/。
3. 新会话优先生成或读取精简启动包，不全文加载历史。
4. 压缩、暂停、任务切换前，写回 active_task.md、task_log.md 和必要 memory card。
5. 搜索、索引、图谱只是导航；关键结论必须回源验证。
6. 凭据、私钥、token、密码、私有端点、账号专属路径不得进入索引、记忆卡片、启动包或任务日志。
7. 默认使用本地 CLI 和静态索引；server、UI、MCP 只作为后续适配层。
8. Markdown 文件是事实源；SQLite/search 索引是可重建派生数据。
9. 需要长期记忆参与时，先 PLAN，再行动，最后 LOG。
10. 记忆规则、检索、写回和评估应持续优化，而不是一次性固定。
11. 使用 Skill + Memory + Tools + Eval：Skill 定义流程，Memory 保存事实，Tools 执行本地操作，Eval 检查质量。
12. 在 Git 仓库内改文件前先检查版本状态；仓库治理先读 memory_cards/repository_governance_policy.md，提交或推送前遵守 memory_cards/agent_git_collaboration_policy.md。

2. 目录结构

mos_core/
  ARCHITECTURE_AND_FLOW.md      中文架构和流程总入口
  mos_always_rules.md           短常驻规则
  AGENTS.md                     完整长期规则入口
  active_task.md                当前任务状态
  task_log.md                   任务 handoff 和日志
  session_bootstrap.md          新会话启动包模板
  skills/                       可复用流程
  memory_cards/                 长期结论卡片
  memory/                       memory 层说明
  tools/                        本地一次性工具
  eval/                         评估层定义
  index_config.json             索引配置
  source_registry.md            回源入口登记

3. 首次使用

0. 最简方式：让 agent 先读 AGENT_QUICK_START_PROMPT.md。
1. 读取 mos_always_rules.md。
2. 读取 ARCHITECTURE_AND_FLOW.md。
3. 检查当前任务：active_task.md。
4. 查看 skill：py -3 tools\mos_cli.py skill-list。
5. 根据任务选择相关 skill。
6. 需要恢复上下文时运行：py -3 tools\mos_cli.py bootstrap "任务关键词"。
7. 需要联想历史经验时运行：py -3 tools\mos_cli.py associate "任务关键词"。
8. 涉及 Git 仓库文件修改前运行：py -3 tools\mos_cli.py git-preflight --repo <repo>。
9. 只读取启动包或联想结果中高相关的 memory card。
10. 关键结论必须打开 source_refs 回源验证。

4. 常用本地命令

py -3 tools\mos_cli.py status
py -3 tools\mos_cli.py skill-list
py -3 tools\mos_cli.py bootstrap "任务关键词"
py -3 tools\mos_cli.py associate "任务关键词"
py -3 tools\mos_cli.py search "关键词" --top-k 8
py -3 tools\mos_cli.py rebuild
py -3 tools\mos_cli.py graph
py -3 tools\mos_cli.py eval-memory
py -3 tools\mos_cli.py git-preflight --repo <repo>

5. 空白包说明

本包是 MOS v3 框架包，默认不应包含用户项目记忆。导入旧记忆前必须先审查、去敏、确认适合迁移。

6. 常驻规则安装

支持 always-on 规则的 agent 软件应安装或引用 mos_always_rules.md。完整规则不应全部常驻；应按触发条件读取。配置模板见 ../agent_config_templates/INSTALL_AGENT_RULES.md。

7. MOS v3 主要新增能力

• ARCHITECTURE_AND_FLOW.md：中文架构、流程和人类使用入口。
• skills/skill_registry.json：按任务触发 skill。
• memory_association_policy.md：低负载记忆联想。
• memory_lifecycle_policy.md：记忆生命周期、动作项关闭和 stale memory 审计。
• memory_consolidation_policy.md：记忆整合、去重、合并和 task log 提炼。
• memory_conflict_policy.md：Git-backed memory 的冲突、diff、merge 和回滚规则。
• memory_graph_policy.md：派生记忆图谱。
• memory_upsert_policy.md：写前检索和 UPSERT。
• memory_operation_trace_policy.md：记忆操作 trace。
• memory_scaffold_evaluation_policy.md：记忆系统评估。
• tools/mos_cli.py：统一本地 CLI 入口。
• tools/memory_manager.py：统一 memory operation 入口。
• skills/memory_lifecycle/SKILL.md：stale memory 审计、动作项关闭、替代和归档流程。
• memory_cards/repository_governance_policy.md：仓库协作治理六组规范。
• skills/repository_governance/SKILL.md：仓库治理、发布规范、文档同步、CI/CD、安全验证流程。
• memory_cards/agent_git_collaboration_policy.md：Git 闭环规范。
• skills/git_platform_operations/SKILL.md：GitHub、GitLab、Gitee、GitLink 平台操作流程。
• skills/prompt_optimization/SKILL.md：提示词优化流程。
• memory_cards/external_agent_skills_absorption_policy.md：外部 agent skill 吸收边界和回源入口。
• skills/superpowers_workflow/SKILL.md：复杂任务工作流编排。
• skills/claude_mem_integration/SKILL.md：Claude Code claude-mem 可选插件安装流程。
• skills/agent_reach_research/SKILL.md：外部平台资料访问和证据回源。
• skills/gitnexus_repo_graph/SKILL.md：仓库知识图谱和影响分析。
• skills/humanizer_zh/SKILL.md：中文自然化和文档润色。
• memory_cards/ui_ux_animation_libraries_policy.md：UI/UX、组件库、图表和动效库吸收边界。
• skills/ui_ux_pro_max_design/SKILL.md：UI/UX 设计和可用性审查。
• skills/react_bits_components/SKILL.md：React Bits 动效组件选型。
• skills/roughviz_charts/SKILL.md：roughViz 手绘风图表规划。
• skills/magic_ui_components/SKILL.md：Magic UI 组件和 MCP/registry 查询规划。
• skills/motion_animation/SKILL.md：Motion 动画编排和交互动效。