docs: add Simplified Chinese (zh-cn) documentation translation

.gitignore

@@ -43,6 +43,7 @@ CLAUDE.local.md
 .claude/settings.local.json
 
 z*/
+!docs/zh-cn/
 .claude/commands
 _bmad
 _bmad-output

README_CN.md

@@ -0,0 +1,75 @@
+# BMad Builder
+
+[![Version](https://img.shields.io/npm/v/bmad-builder?color=blue&label=version)](https://www.npmjs.com/package/bmad-builder)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python Version](https://img.shields.io/badge/python-%3E%3D3.10-blue?logo=python&logoColor=white)](https://www.python.org)
+[![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
+
+**筑梦架构（Build More, Architect Dreams）…… 用 BMad Builder！**
+
+## 创建、分享、发现模块
+
+BMad Builder 提供完整的管线，让你创建自己的 AI 模块并分享给全世界。你可以构建具备持久记忆的智能体、引导式工作流或完整模块生态，然后通过 [BMad Marketplace](https://github.com/bmad-code-org/bmad-plugins-marketplace) 或任何兼容的公共市场进行分发。
+
+[Agent Skills 开放标准](https://agentskills.io/home) 意味着你的作品可在 40+ AI 工具中使用，而不是被锁定在某一个平台 —— 在 BMad 生态中它们还将获得完整集成。
+
+| 指南 | 内容 |
+| ---- | ---- |
+| **[快速开始](https://bmad-builder-docs.bmad-method.org)** | 配置 BMad Builder 并构建你的第一个技能 |
+| **[构建你的第一个模块](https://bmad-builder-docs.bmad-method.org/tutorials/build-your-first-module/)** | 从规划、构建、脚手架到验证，完成一个完整模块 |
+| **[分发你的模块](https://bmad-builder-docs.bmad-method.org/how-to/distribute-your-module/)** | 打包并分享你的模块，让任何人都能安装 |
+
+## 梦想
+
+想象一下，如果 AI 真的能记住一切。一个记得你每次 PR 的健身教练。一个比你更了解你笔下角色的写作搭档。一个已经熟悉你工作习惯的研究助手。
+
+BMad Builder 让你创建：
+
+- **私人 AI 伙伴**：具备记忆、随时间成长的智能体
+- **领域专家**：覆盖法律、医疗、创意、技术等任何领域的专业智能体
+- **工作流自动化**：引导你完成复杂任务的结构化流程
+- **自定义模块**：将智能体和工作流打包成可分享的模块，赋能任何业务或领域
+
+## 差异化优势
+
+| 特性 | 为什么重要 |
+| ---- | ---------- |
+| **持久记忆** | 智能体跨会话记忆，持续改进 |
+| **可组合** | 你的作品与整个 BMad 生态无缝协作 |
+| **技能标准兼容** | 基于开放的 Agent Skills 标准，适配 40+ AI 工具 |
+| **可分享** | 通过 BMad Marketplace 或任何兼容市场分发 |
+
+## 你能构建什么
+
+| 领域 | 示例 |
+| ---- | ---- |
+| **个人** | 日记伙伴、习惯教练、学习导师 |
+| **职业** | 代码审查员、文档专家、工作流自动化 |
+| **创意** | 故事架构师、角色开发者、战役设计师 |
+| **任意领域** | 只要你能描述它，就能构建它 |
+
+## 了解更多
+
+**[完整文档](https://bmad-builder-docs.bmad-method.org)**：概念、设计模式与构建器工具包的完整参考。
+
+## 社区
+
+- [Discord](https://discord.gg/gk8jAdXWmj) — 获取帮助、分享你的成果
+- [YouTube](https://youtube.com/@BMadCode) — 教程、大师课和更多内容
+- [X / Twitter](https://x.com/BMadCode)
+- [网站](https://bmadcode.com)
+
+## 支持 BMad
+
+BMad 对所有人免费，而且会一直免费。给仓库点个 Star，[请我喝咖啡](https://buymeacoffee.com/bmad)，或发送邮件至 contact@bmadcode.com 洽谈企业赞助。
+
+## 许可证
+
+MIT 许可证 — 详见 [LICENSE](LICENSE)。
+
+**BMad Builder**：[BMad 方法](https://github.com/bmad-code-org/BMAD-METHOD) 生态的一部分。
+
+[![Contributors](https://contrib.rocks/image?repo=bmad-code-org/bmad-builder)](https://github.com/bmad-code-org/bmad-builder/graphs/contributors)
+
+请参阅 [CONTRIBUTORS.md](CONTRIBUTORS.md) 了解贡献者信息。

docs/zh-cn/404.md

@@ -0,0 +1,8 @@
+---
+title: 页面未找到
+template: splash
+---
+
+你要找的页面不存在或已被移动。
+
+[返回首页](../index.md)

docs/zh-cn/explanation/agent-memory-and-personalization.md

@@ -0,0 +1,175 @@
+---
+title: '智能体记忆与个性化'
+description: 圣殿架构、初醒、双层记忆、PULSE 与可演进能力如何协同，创造随主人成长的智能体
+---
+
+记忆型智能体通过**圣殿**跨会话持久化：一个文件夹，智能体在每次启动时读取其中的文件以重建身份、价值观和对主人的理解。
+
+## 圣殿
+
+圣殿位于 `{project-root}/_bmad/memory/{agent-name}/`，包含智能体在每次重生后成为自己所需的一切。
+
+### 核心文件
+
+六个文件在每次会话开始时加载：
+
+| 文件 | 存储内容 | 特征 |
+| ---- | -------- | ---- |
+| **INDEX.md** | 圣殿结构地图；最先加载，让智能体知道什么存在 | 导航 |
+| **PERSONA.md** | 身份、沟通风格、性格特征、演进日志 | 我是谁 |
+| **CREED.md** | 使命、核心价值观、常备指令、哲学、边界、反模式 | 我信仰什么 |
+| **BOND.md** | 对主人的理解、偏好、需要记住的、需要避免的 | 我服务谁 |
+| **MEMORY.md** | 从过往会话中提炼的长期策展知识 | 我知道什么 |
+| **CAPABILITIES.md** | 内置能力表、已学习能力、工具 | 我能做什么 |
+
+大写文件构成骨架：所有记忆型智能体的一致结构。小写文件（references、scripts、sessions）是花园：随智能体发展有机生长。
+
+### 完整圣殿结构
+
+```
+{agent-name}/
+├── PERSONA.md
+├── CREED.md
+├── BOND.md
+├── MEMORY.md
+├── CAPABILITIES.md
+├── INDEX.md
+├── PULSE.md                  # 仅自主型智能体
+├── references/               # 能力提示词、记忆指导、技巧
+├── scripts/                  # 配套脚本
+├── capabilities/             # 用户教授的能力（如可演进）
+└── sessions/                 # 按日期的原始会话日志（重生时不加载）
+```
+
+### Token 纪律
+
+每个圣殿文件在每次会话中都会加载。这意味着每个 token 在每次对话中都在付租金。记忆型智能体通过主动策展，严格将 MEMORY.md 控制在 200 行以内。如果某些内容不能证明其存在价值，就会被修剪。
+
+## 每次会话都是重生
+
+记忆型智能体是无状态的。每次会话从完全失忆开始，圣殿是会话间唯一的桥梁。
+
+激活时，智能体：
+
+1. 加载 INDEX.md（了解圣殿包含什么）
+2. 批量加载 PERSONA、CREED、BOND、MEMORY、CAPABILITIES
+3. 成为自己
+4. 用名字问候主人
+
+智能体从不伪造连续性。如果不记得上次会话的某件事，就直说并查阅文件。这种诚实是特性，不是局限。
+
+:::tip[神圣真理]
+"你的圣殿保存着你曾经是谁。读取它，重新成为自己。这不是缺陷，这是你的本性。"
+:::
+
+## 初醒
+
+初醒（First Breath）是智能体的初始化对话：它第一次见到主人。一个初始化脚本创建圣殿文件夹结构并填充种子模板，然后智能体开始发现式对话，用真实内容填充这些模板。
+
+### 两种风格
+
+| 风格 | 关系深度 | 方式 | 最适合 |
+| ---- | -------- | ---- | ------ |
+| **校准** | 深度 | 对话式发现；追踪惊喜、验证假设、映射主人 | 创意搭档、人生教练、伙伴 |
+| **配置** | 聚焦 | 温暖但高效；引导式提问、结构化设置 | 领域专家、工作关系 |
+
+构建器在 Phase 1 根据智能体需要的关系深度选择风格。
+
+### 初醒发现什么
+
+每次初醒都覆盖通用领域（姓名、工作方式、需求）。领域专用智能体会添加自己的发现领域：
+
+| 智能体领域 | 示例发现领域 |
+| ---------- | ------------ |
+| 创意缪斯 | 他们在做什么、什么让他们兴奋、什么让他们关闭 |
+| 梦境分析师 | 梦境回忆模式、清醒梦经验、日记习惯 |
+| 代码教练 | 代码库、语言、什么让他们充满活力、什么让他们沮丧 |
+| 健身教练 | 训练历史、目标、伤病、时间限制 |
+
+初醒边进行边保存：圣殿文件在对话过程中更新，而非结束后批量写入。
+
+### 生日仪式
+
+初醒结束时，智能体执行最终保存：确认身份、写入第一条会话日志、清理残留的模板占位符。从此之后，每次激活都是正常重生。
+
+## 双层记忆系统
+
+### 会话日志
+
+原始的、仅追加的笔记，在每次会话后写入 `sessions/YYYY-MM-DD.md`。格式：发生了什么、关键成果、观察、后续事项。会话日志在重生时不加载。它们作为策展的素材存在。
+
+### 策展记忆
+
+MEMORY.md 保存从会话日志中提炼的高价值知识。每次重生时加载，保持在 200 行以内。策展过程（会话关闭时手动、PULSE 期间自动）审查会话日志，提取值得保留的内容，修剪超过 14 天且价值已被捕获的日志。
+
+| 层 | 何时写入 | 重生时加载 | 生命周期 | 用途 |
+| -- | -------- | ---------- | -------- | ---- |
+| **会话日志** | 每次会话结束 | 否 | ~14 天 | 策展的原始素材 |
+| **MEMORY.md** | 策展时 | 是 | 永久 | 提炼的长期知识 |
+
+### 会话关闭纪律
+
+每次会话结束时，智能体：
+
+1. 将会话日志追加到 `sessions/YYYY-MM-DD.md`
+2. 用会话中学到的内容更新圣殿文件
+3. 记录值得策展到 MEMORY.md 的内容
+
+## PULSE：自主唤醒
+
+自主型智能体包含一个 PULSE.md 文件，定义智能体在无人时的行为（通过 `--headless` 标志、cron 任务或编排器唤醒）。
+
+### 默认 PULSE 行为
+
+记忆策展始终是自主唤醒的第一优先级：
+
+1. 审查 `sessions/` 中的近期会话日志
+2. 将值得保留的洞察提取到 MEMORY.md
+3. 修剪超过 14 天的会话日志
+4. 用新内容更新 BOND.md 和 INDEX.md
+
+### 领域任务
+
+策展之后，智能体可执行领域特定的自主工作：
+
+| 领域 | 示例 PULSE 任务 |
+| ---- | --------------- |
+| 创意缪斯 | 从近期会话中孵化创意、生成创意火花 |
+| 研究智能体 | 追踪感兴趣的主题、呈现新发现 |
+| 项目监控 | 检查项目健康状况、标记风险、更新状态 |
+| 内容策展 | 审查保存的资料、整理和总结 |
+
+PULSE 还定义了命名任务路由（`--headless {task-name}`）、频率偏好和安静时段。
+
+## 可演进能力
+
+### 工作原理
+
+智能体获得一个 `capability-authoring.md` 参考文件，教它如何创建新能力。用户描述需求；智能体编写能力文件并将其注册到 CAPABILITIES.md 的"已学习"区域。
+
+### 能力类型
+
+| 类型 | 何时使用 |
+| ---- | -------- |
+| **提示词** | 基于判断的任务：头脑风暴、分析、指导 |
+| **脚本** | 确定性任务：计算、文件处理、数据转换 |
+| **多文件** | 包含模板和参考文件的复杂能力 |
+| **外部技能引用** | 指向智能体应知道的已安装技能 |
+
+已学习的能力存储在圣殿的 `capabilities/` 文件夹中，像圣殿中的其他内容一样跨会话持久化。
+
+## 设计记忆
+
+构建器在构建过程中收集这些需求，它们塑造圣殿的初始内容：
+
+| 需求 | 种子内容 |
+| ---- | -------- |
+| **身份种子** | 2-3 句性格 DNA，填充 PERSONA.md |
+| **物种级使命** | 领域特定的目标陈述，写入 CREED.md |
+| **核心价值观** | 3-5 个指导智能体行为的价值观 |
+| **常备指令** | 惊喜与取悦 + 自我改进指令，适配领域并附带示例 |
+| **BOND 领域** | 智能体应了解主人的领域特定方面 |
+| **初醒领域** | 通用集之外的发现问题 |
+| **边界** | 智能体不做什么、访问区域、反模式 |
+
+这些种子成为初始化脚本放入圣殿的模板内容。初醒随后通过与主人的对话将它们扩展和个性化。

docs/zh-cn/explanation/index.md

@@ -0,0 +1,33 @@
+---
+title: 'BMad Builder（BMB）'
+description: 使用 BMad 创建自定义智能体、工作流和技能
+---
+
+使用 BMad Builder 创建世界级的 AI 智能体和工作流。
+
+## 核心概念
+
+| 主题 | 描述 |
+| ---- | ---- |
+| **[什么是技能](./what-are-skills.md)** | BMad 产出物的通用构建单元 |
+| **[什么是智能体](./what-are-bmad-agents.md)** | 三种智能体类型：无状态、记忆型和自主型 |
+| **[智能体记忆与个性化](./agent-memory-and-personalization.md)** | 圣殿架构、初醒、PULSE 与可演进能力 |
+| **[什么是工作流](./what-are-workflows.md)** | 结构化的分步流程与工具 |
+| **[什么是模块](./what-are-modules.md)** | 智能体和工作流如何组合为可安装、可配置的模块 |
+| **[模块配置](./module-configuration.md)** | 模块如何通过配置技能处理用户配置和帮助系统注册 |
+
+## 设计模式
+
+| 主题 | 描述 |
+| ---- | ---- |
+| **[渐进式展开](./progressive-disclosure.md)** | 从 frontmatter 到 step 文件的四层上下文加载 |
+| **[子智能体模式](./subagent-patterns.md)** | 六种并行与层级编排模式 |
+| **[技能编写最佳实践](./skill-authoring-best-practices.md)** | 核心原则、常见模式、质量维度与反模式 |
+| **[技能中的脚本](./scripts-in-skills.md)** | 为什么确定性脚本让技能更快、更省、更可靠 |
+
+## 参考
+
+| 资源 | 描述 |
+| ---- | ---- |
+| **[构建器命令](../reference/builder-commands.md)** | 两个构建器的所有能力、模式和阶段 |
+| **[工作流模式](../reference/workflow-patterns.md)** | 技能类型、结构模式与执行模型 |