From 347f459d5db9d690993db06c8d78580793236766 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=A2=81=E5=B1=B1=E6=B2=B3?= <392425595@qq.com> Date: Mon, 23 Mar 2026 00:08:35 +0800 Subject: [PATCH] docs(zh-cn): refine entry copy and navigation (#2092) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs(zh-cn): refine entry copy and navigation 我统一中文入口层文案语气，减少机翻腔并保持与英文语义一致， 让读者从 README、首页到 404 与界面文案都保持同一术语和导航预期。 Feishu: https://www.feishu.cn/ Made-with: Cursor * docs(zh-cn): align non-interactive install link label 我把 README_CN 中“查看完整安装选项”改为“查看非交互式安装选项”。 此前文案范围大于目标页面内容，容易让读者误以为是安装总览；现在文案与链接目标保持一致，减少理解偏差。 Feishu: Made-with: Cursor --------- Co-authored-by: leon --- README_CN.md | 59 +++++++++++------------------ docs/zh-cn/404.md | 4 +- docs/zh-cn/index.md | 53 +++++++++++--------------- website/src/content/i18n/zh-CN.json | 20 +++++----- 4 files changed, 57 insertions(+), 79 deletions(-) diff --git a/README_CN.md b/README_CN.md index 0d7af6ede..a939a0c7b 100644 --- a/README_CN.md +++ b/README_CN.md @@ -5,20 +5,20 @@ [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org) [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj) -**突破性敏捷 AI 驱动开发方法** — 简称 “BMAD 方法论” ，BMAD方法论是由多个模块生态构成的AI驱动敏捷开发模块系统，这是最佳且最全面的敏捷 AI 驱动开发框架，具备真正的规模自适应人工智能，可适应快速开发，适应企业规模化开发。 +**筑梦架构（Build More Architect Dreams）** —— 简称 “BMAD 方法”，面向 BMad 模块生态的 AI 驱动敏捷开发方法。它会随项目复杂度调整工作深度，从日常 bug 修复到企业级系统建设都能适配。 -**100% 免费且开源。** 无付费。无内容门槛。无封闭 Discord。我们赋能每个人，我们将为全球现在在人工智能领域发展的普通人提供公平的学习机会。 +**100% 免费且开源。** 没有付费墙，没有封闭内容，也没有封闭 Discord。我们希望每个人都能平等获得高质量的人机协作开发方法。 ## 为什么选择 BMad 方法？ -传统 AI 工具替你思考，产生平庸的结果。BMad 智能体和辅助工作流充当专家协作者，引导你通过结构化流程，与 AI 的合作发挥最佳思维，产出最有效优秀的结果。 +传统 AI 工具常常替你思考，结果往往止于“能用”。BMad 通过专业智能体和引导式工作流，让 AI 成为协作者：流程有结构，决策有依据，产出更稳定。 -- **AI 智能帮助** — 随时使用 `bmad-help` 获取下一步指导 -- **规模-领域自适应** — 根据项目复杂度自动调整规划深度 -- **结构化工作流** — 基于分析、规划、架构和实施的敏捷最佳实践 -- **专业智能体** — 12+ 领域专家（PM、架构师、开发者、UX、Scrum Master 等） -- **派对模式** — 将多个智能体角色带入一个会话进行协作和讨论 -- **完整生命周期** — 从想法开始（头脑风暴）到部署发布 +- **AI 智能引导** —— 随时调用 `bmad-help` 获取下一步建议 +- **规模与领域自适应** —— 按项目复杂度自动调整规划深度 +- **结构化工作流** —— 覆盖分析、规划、架构、实施全流程 +- **专业角色智能体** —— 提供 PM、架构师、开发者、UX、Scrum Master 等 12+ 角色 +- **派对模式** —— 多个智能体可在同一会话协作讨论 +- **完整生命周期** —— 从头脑风暴一路到交付上线 [在 **docs.bmad-method.org** 了解更多](https://docs.bmad-method.org/zh-cn/) @@ -26,7 +26,7 @@ ## 🚀 BMad 的下一步是什么？ -**V6 已到来，我们才刚刚开始！** BMad 方法正在快速发展，包括跨平台智能体团队和子智能体集成、技能架构、BMad Builder v1、开发循环自动化等优化，以及更多正在开发中的功能。 +**V6 已经上线，而这只是开始。** BMad 仍在快速演进：跨平台智能体团队与子智能体集成、Skills 架构、BMad Builder v1、Dev Loop 自动化等能力都在持续推进。 **[📍 查看完整路线图 →](https://docs.bmad-method.org/zh-cn/roadmap/)** @@ -40,7 +40,7 @@ npx bmad-method install ``` -> 想要最新的预发布版本？使用 `npx bmad-method@next install`。相比默认安装，可能会有更多变更。 +> 想体验最新预发布版本？可使用 `npx bmad-method@next install`。它比默认版本更新更快，也可能更容易发生变化。 按照安装程序提示操作，然后在项目文件夹中打开你的 AI IDE（Claude Code、Cursor 等）。 @@ -52,19 +52,19 @@ npx bmad-method install --directory /path/to/project --modules bmm --tools claud [查看非交互式安装选项](https://docs.bmad-method.org/zh-cn/how-to/non-interactive-installation/) -> **不确定该做什么？** 运行 `bmad-help` — 它会准确告诉你下一步做什么以及什么是可选的。你也可以问诸如 `bmad-help 我刚刚完成了架构设计，接下来该做什么？` 之类的问题。 +> **不确定下一步？** 直接问 `bmad-help`。它会告诉你“必做什么、可选什么”，例如：`bmad-help 我刚完成架构设计，接下来做什么？` ## 模块 -BMad 方法通过官方模块扩展到专业领域。可在安装期间或之后的任何时间使用。 +BMad 可通过官方模块扩展到不同专业场景。你可以在安装时选择，也可以后续随时补装。 -| Module | Purpose | -| ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | 包含 34+ 工作流的核心框架 | -| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | 创建自定义 BMad 智能体和工作流 | -| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | 基于风险的测试策略和自动化 | -| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | 游戏开发工作流（Unity、Unreal、Godot） | -| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | 创新、头脑风暴、设计思维 | +| 模块 | 用途 | +| ----------------------------------------------------------------------------------------------------------------- | ---------------------------- | +| **[BMad Method (BMM)](https://github.com/bmad-code-org/BMAD-METHOD)** | 核心框架，内含 34+ 工作流 | +| **[BMad Builder (BMB)](https://github.com/bmad-code-org/bmad-builder)** | 创建自定义 BMad 智能体与工作流 | +| **[Test Architect (TEA)](https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise)** | 基于风险的测试策略与自动化 | +| **[Game Dev Studio (BMGD)](https://github.com/bmad-code-org/bmad-module-game-dev-studio)** | 游戏开发工作流（Unity/Unreal/Godot） | +| **[Creative Intelligence Suite (CIS)](https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite)** | 创新、头脑风暴、设计思维 | ## 文档 @@ -72,10 +72,9 @@ BMad 方法通过官方模块扩展到专业领域。可在安装期间或之后 **快速链接：** - [入门教程](https://docs.bmad-method.org/zh-cn/tutorials/getting-started/) -- [从先前版本升级](https://docs.bmad-method.org/zh-cn/how-to/upgrade-to-v6/) +- [从旧版本升级](https://docs.bmad-method.org/zh-cn/how-to/upgrade-to-v6/) - [测试架构师文档（英文）](https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/) - ## 社区 - [Discord](https://discord.gg/gk8jAdXWmj) — 获取帮助、分享想法、协作 @@ -85,9 +84,9 @@ BMad 方法通过官方模块扩展到专业领域。可在安装期间或之后 ## 支持 BMad -BMad 对每个人都是免费的 — 并且永远如此。如果你想支持开发： +BMad 对所有人免费，而且会一直免费。如果你愿意支持项目发展： -- ⭐ 请点击此页面右上角附近的项目星标图标 +- ⭐ 给仓库点个 Star - ☕ [请我喝咖啡](https://buymeacoffee.com/bmad) — 为开发提供动力 - 🏢 企业赞助 — 在 Discord 上私信 - 🎤 演讲与媒体 — 可参加会议、播客、采访（在 Discord 上联系 BM） @@ -107,15 +106,3 @@ MIT 许可证 — 详见 [LICENSE](LICENSE)。 [![Contributors](https://contrib.rocks/image?repo=bmad-code-org/BMAD-METHOD)](https://github.com/bmad-code-org/BMAD-METHOD/graphs/contributors) 请参阅 [CONTRIBUTORS.md](CONTRIBUTORS.md) 了解贡献者信息。 - ---- -## 术语说明 - -- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。 -- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定目标。 -- **CI/CD**：持续集成/持续部署。一种自动化软件开发实践，用于频繁集成代码更改并自动部署。 -- **IDE**：集成开发环境。提供代码编辑、调试、构建等功能的软件开发工具。 -- **PM**：产品经理。负责产品规划、需求管理和团队协调的角色。 -- **UX**：用户体验。指用户在使用产品或服务过程中的整体感受和交互体验。 -- **Scrum Master**：Scrum 主管。敏捷开发 Scrum 框架中的角色，负责促进团队遵循 Scrum 流程。 -- **PRD**：产品需求文档。详细描述产品功能、需求和规格的文档。 diff --git a/docs/zh-cn/404.md b/docs/zh-cn/404.md index bb835ceea..d8d1bb9e9 100644 --- a/docs/zh-cn/404.md +++ b/docs/zh-cn/404.md @@ -4,6 +4,6 @@ template: splash --- -您查找的页面不存在或已被移动。 +你访问的页面不存在，或已被移动。 -[返回首页](./index.md) +[返回中文首页](./index.md) diff --git a/docs/zh-cn/index.md b/docs/zh-cn/index.md index 5021d18cc..86438f2eb 100644 --- a/docs/zh-cn/index.md +++ b/docs/zh-cn/index.md @@ -1,55 +1,55 @@ --- title: 欢迎使用 BMad 方法 -description: 具备专业智能体、引导式工作流和智能规划的 AI 驱动开发框架 +description: 具备专业智能体、引导式工作流与智能规划的 AI 驱动开发框架 --- -BMad 方法（**B**reakthrough **M**ethod of **A**gile AI **D**riven Development，敏捷 AI 驱动开发的突破性方法）是 BMad 方法生态系统中的一个 AI 驱动开发框架模块，帮助您完成从构思和规划到智能体实现的整个软件开发过程。它提供专业的 AI 智能体、引导式工作流和智能规划，能够根据您项目的复杂度进行调整，无论是修复错误还是构建企业平台。 +BMad 方法（**B**uild **M**ore **A**rchitect **D**reams）是 BMad 方法生态中的 AI 驱动开发框架模块，覆盖从构思、规划到智能体实施的完整软件交付流程。它提供专业智能体、引导式工作流和可随项目复杂度调整的智能规划，无论是修复 bug 还是构建企业级平台都适用。 -如果您熟悉使用 Claude、Cursor 或 GitHub Copilot 等 AI 编码助手，就可以开始使用了。 +如果你已经习惯使用 Claude、Cursor 或 GitHub Copilot 这类 AI 编码助手，现在就可以开始。 :::note[🚀 V6 已发布，我们才刚刚起步！] 技能架构、BMad Builder v1、开发循环自动化以及更多功能正在开发中。**[查看路线图 →](/zh-cn/roadmap/)** ::: -## 新手入门？从教程开始 +## 新手入门？先从教程开始 理解 BMad 的最快方式是亲自尝试。 -- **[BMad 入门指南](./tutorials/getting-started.md)** — 安装并了解 BMad 的工作原理 -- **[工作流地图](./reference/workflow-map.md)** — BMM 阶段、工作流和上下文管理的可视化概览 +- **[BMad 入门教程](./tutorials/getting-started.md)** — 安装并理解 BMad 如何工作 +- **[工作流地图](./reference/workflow-map.md)** — BMM 阶段、工作流与上下文管理的全景视图 :::tip[只想直接上手？] -安装 BMad 并运行 `bmad-help` — 它会根据您的项目和已安装的模块引导您完成所有操作。 +安装 BMad 后运行 `bmad-help`，它会根据你的项目状态和已安装模块给出下一步建议。 ::: -## 如何使用本文档 +## 如何使用这些文档 -本文档根据您的目标分为四个部分： +这些文档按你的目标分成四个部分： -| 部分 | 用途 | -| ----------------- | ---------------------------------------------------------------------------------------------------------- | -| **教程** | 以学习为导向。通过分步指南引导您构建内容。如果您是新手，请从这里开始。 | -| **操作指南** | 以任务为导向。解决特定问题的实用指南。"如何自定义智能体？"等内容位于此处。 | -| **说明** | 以理解为导向。深入探讨概念和架构。当您想知道*为什么*时阅读。 | -| **参考** | 以信息为导向。智能体、工作流和配置的技术规范。 | +| 部分 | 用途 | +| --- | --- | +| **教程** | 学习导向。通过分步引导带你做成一件事。第一次使用建议从这里开始。 | +| **操作指南** | 任务导向。解决具体问题的实用文档，例如“如何自定义智能体”。 | +| **说明** | 理解导向。深入讲解概念与架构，适合回答“为什么”。 | +| **参考** | 信息导向。提供智能体、工作流和配置项的技术规格。 | -## 扩展和自定义 +## 扩展与自定义 -想要使用自己的智能体、工作流或模块来扩展 BMad 吗？**[BMad Builder（英文）](https://bmad-builder-docs.bmad-method.org/)** 提供了创建自定义扩展的框架和工具，无论是为 BMad 添加新功能还是从头开始构建全新的模块。 +想用自己的智能体、工作流或模块扩展 BMad？**[BMad Builder（英文）](https://bmad-builder-docs.bmad-method.org/)** 提供了创建自定义扩展所需的框架与工具，无论是给 BMad 添加能力，还是从零构建新模块都可以。 -## 您需要什么 +## 你需要准备什么 -BMad 可与任何支持自定义系统提示词或项目上下文的 AI 编码助手配合使用。热门选项包括： +BMad 可与任何支持自定义系统提示词或项目上下文的 AI 编码助手配合使用，常见选择包括： - **[Claude Code](https://code.claude.com)** — Anthropic 的 CLI 工具（推荐） - **[Cursor](https://cursor.sh)** — AI 优先的代码编辑器 - **[Codex CLI](https://github.com/openai/codex)** — OpenAI 的终端编码智能体 -您应该熟悉版本控制、项目结构和敏捷工作流等基本软件开发概念。无需具备 BMad 风格智能体系统的先验经验——这正是本文档的作用。 +你需要了解一些基础软件工程概念，例如版本控制、项目结构和敏捷工作流。即使没有使用过 BMad 风格智能体系统，也可以从这些文档开始上手。 ## 加入社区 -获取帮助、分享您的构建内容，或为 BMad 做出贡献： +获取帮助、分享成果，或参与贡献： - **[Discord](https://discord.gg/gk8jAdXWmj)** — 与其他 BMad 用户聊天、提问、分享想法 - **[GitHub](https://github.com/bmad-code-org/BMAD-METHOD)** — 源代码、问题和贡献 @@ -57,13 +57,4 @@ BMad 可与任何支持自定义系统提示词或项目上下文的 AI 编码 ## 下一步 -准备开始了吗？**[BMad 入门指南](./tutorials/getting-started.md)** 并构建您的第一个项目。 - ---- -## 术语说明 - -- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。 -- **AI-driven**：AI 驱动。指由人工智能技术主导或驱动的系统或方法。 -- **workflow**：工作流。指一系列有序的任务或步骤，用于完成特定目标。 -- **prompt**：提示词。指输入给 AI 模型的指令或问题，用于引导其生成特定输出。 -- **context**：上下文。指在特定场景下理解信息所需的背景信息或环境。 +准备好开始了吗？**[从 BMad 入门教程开始](./tutorials/getting-started.md)**，构建你的第一个项目。 diff --git a/website/src/content/i18n/zh-CN.json b/website/src/content/i18n/zh-CN.json index 35c916a62..a37ff1505 100644 --- a/website/src/content/i18n/zh-CN.json +++ b/website/src/content/i18n/zh-CN.json @@ -1,5 +1,5 @@ { - "skipLink.label": "跳转到内容", + "skipLink.label": "跳到正文", "search.label": "搜索", "search.ctrlKey": "Ctrl", "search.cancelLabel": "取消", @@ -9,20 +9,20 @@ "themeSelect.auto": "自动", "languageSelect.accessibleLabel": "选择语言", "menuButton.accessibleLabel": "菜单", - "sidebarNav.accessibleLabel": "主导航", - "tableOfContents.onThisPage": "本页内容", - "tableOfContents.overview": "概述", - "i18n.untranslatedContent": "此内容尚未提供中文翻译。", - "page.editLink": "编辑页面", + "sidebarNav.accessibleLabel": "侧边导航", + "tableOfContents.onThisPage": "本页目录", + "tableOfContents.overview": "概览", + "i18n.untranslatedContent": "这部分内容暂未提供中文版本。", + "page.editLink": "编辑此页", "page.lastUpdated": "最后更新：", "page.previousLink": "上一页", "page.nextLink": "下一页", - "page.draft": "此内容为草稿，不会包含在正式版本中。", - "404.text": "页面未找到。请检查 URL 或尝试使用搜索。", + "page.draft": "此内容为草稿，不会出现在正式版本中。", + "404.text": "页面未找到。请检查地址，或使用站内搜索。", "aside.note": "注意", "aside.tip": "提示", "aside.caution": "警告", "aside.danger": "危险", - "fileTree.directory": "目录", - "builtWithStarlight.label": "使用 Starlight 构建" + "fileTree.directory": "文件夹", + "builtWithStarlight.label": "由 Starlight 构建" }