build-memory

工作空间初始化

在项目根目录创建或完善五个受管文件：AGENTS.md、CLAUDE.md、CHANGELOG.md、SESSION_LOG.md、TODO.md，并补充轻量 .memory/ 支撑目录，用于稳定写入 session log 和沉淀长期经验。

四条不可妥协的规则：

• 单点事实来源 (Single Source of Truth)。 所有通用的项目规则、命令、技术栈均写入 AGENTS.md。CLAUDE.md 仅作为一个极简的入口，强制要求通过 @AGENTS.md 引用它。禁止在 CLAUDE.md 中重复写具体命令。
• 脚本化写入 session 记录。 Agent 应优先使用 python .memory/session_log.py 追加 session 记录，而不是手工编辑 SESSION_LOG.md；脚本负责锁、7 天归档和结构化格式。
• 不静默改写。 未经用户明确同意，不得覆盖或删除已有内容。
• 真实时间。 写入任何受管文件中的时间戳之前，必须通过 shell 命令（date、date -Iseconds、Get-Date 等）获取系统真实时间。不得凭记忆编造时间戳。

模板仅以英文形式存放于 assets/，写入时按目标语言翻译。

工作流

1. 选择语言

对于新建文件：

• 明确指令（“use English”、“用中文”、“create in Japanese”）→ 使用该语言。
• 实质性用户输入（除单纯调用外，附带任意语言的指令或上下文）→ 检测该输入的语言。
• 空调用（仅 /build-memory、“init workspace” 或类似无附加要求的调用）→ 询问用户使用哪种语言，不要猜测。

对于完善已有文件，沿用文件原语言，不进行翻译。

2. 阶段一：审查与提议 (Audit & Propose) - 强制门禁

在任何写入或修改之前，必须先收集事实：

• 顶层文件与目录
• 包管理器 / 语言 / 框架（package.json、pyproject.toml 等）
• 来自配置脚本的真实命令
• 完整读取工作区中已存在的所有规则受管文件（无论是标准的、 AGENTS.md 还是旧的 CLAUDE.md、.cursor/rules 等）。
• 检查是否存在 .memory/INDEX.md，并校检 .memory/KNOWLEDGE.md 中的所有 ### 标题是否在 INDEX.md 中配置了路由。

空工作空间检测。 若检查时未发现源码、包清单、构建配置——即仅含 .git、README 等——在写入前先停下并询问用户：暂时跳过，或者简述项目生成骨架。不要盲目填充占位符。

对于非空工作空间，输出一份《重构计划清单》，明确列出：

1. 缺少哪些基础设施（如 .memory/session_log.py 需要物理拷贝）。
2. 发现了哪些现有的项目核心业务规则、评价原则等，并明确承诺这些内容将被原封不动地保留。
3. 计划如何重组 AGENTS.md 和 CLAUDE.md。

3. 阶段二：物理基建强行挂载 (Infrastructure Scaffolding)

一旦获得用户批准，第一步永远是物理复刻资产。

• 无论项目中是否存在旧的或非标准的规则文件夹，你都必须将 Skill 中的 assets/.memory/ 目录及其内部脚本完整复制到项目的根目录下。
• 如果不存在 .memory/INDEX.md，从 assets 复制默认模板。
• 绝不允许“借用旧框架”或“迎合非标准结构”。标准的 .memory 目录及 session_log.py 是不可动摇的基础设施。

4. 阶段三：差量融合与严格分区 (Differential Merging)

在创建缺失文件或完善已有文件时，必须遵循带有严格分区的“差量融合（Differential Merging）”原则。整体结构必须强制对齐模板的骨架（Headings），但各区块内容的处理方式不同：

绝对红线区 (Strict Zone)：

• 对于 AGENTS.md 中的 ## Memory Layer 这一小节，你必须一字不差地 100% 复制 assets/AGENTS.md 模板中的内容。绝对不允许任何自创、删减或改写，否则会导致记忆系统脚本失效。
• 确保 CLAUDE.md 被清理为仅仅保留一句 @AGENTS.md 的引用，杜绝在 CLAUDE.md 中冗余具体规则。