docs(zh-cn): refine Epic3 story 3.3 and 3.4 explanations#2099
docs(zh-cn): refine Epic3 story 3.3 and 3.4 explanations#2099alexeyv merged 2 commits intobmad-code-org:mainfrom
Conversation
🤖 Augment PR SummarySummary: This PR refines the Chinese “Explanation” docs for Epic 3 Story 3.3–3.4 to make collaboration modes and review modes easier to choose and apply. Changes:
Technical Notes: The PR is documentation-only and is intended to improve conceptual clarity while staying aligned with current workflow naming and internal link conventions. 🤖 Was this summary useful? React with 👍 or 👎 |
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (5)
📝 WalkthroughWalkthroughThis PR rewrites documentation for five Chinese language explanation documents covering BMAD methodology features: advanced elicitation, adversarial review, brainstorming, party mode, and quick dev. Changes restructure content around consistent sections including use-case guidance, limitations, comparison tables with related modes, and cross-references. Changes
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~20 minutes Possibly related PRs
Suggested reviewers
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment Tip CodeRabbit can use oxc to improve the quality of JavaScript and TypeScript code reviews.Add a configuration file to your project to customize how CodeRabbit runs oxc. |
|
Already fully checked, please @alexeyv merge. |
我重写头脑风暴、高级启发与 Party Mode 的中文说明,明确三者在适用场景、价值和边界上的差异,避免字面对译带来的误用。 我同步收敛 Quick Dev 与对抗性评审文案,强调各自定位与配合关系,并补齐中文优先链路和当前 workflow 命名。 feishu: https://feishu.cn/wiki/TODO Made-with: Cursor
我将五篇 explanation 文档里的四冒号提示块语法统一为三冒号,确保与当前文档渲染规则一致。 此前这些文档混用不同围栏写法,容易在审阅和渲染中引入不必要差异;现在统一后可减少维护噪音。 feishu: https://feishu.cn/wiki/TODO Made-with: Cursor
3e71583 to
7337aea
Compare
What
This PR updates five Chinese explanation pages for Epic 3 Story 3.3 and Story 3.4:
docs/zh-cn/explanation/brainstorming.md,docs/zh-cn/explanation/advanced-elicitation.md,docs/zh-cn/explanation/party-mode.md,docs/zh-cn/explanation/quick-dev.md, anddocs/zh-cn/explanation/adversarial-review.md. It clarifies mode positioning, usage boundaries, and value differences, while keeping workflow naming and internal links aligned with current conventions.Why
The previous Chinese pages still had literal-translation traces and blurred boundaries between adjacent modes (brainstorming vs advanced elicitation vs party mode, and quick dev vs adversarial review), which could lead to mode misuse. This change improves conceptual clarity and operational guidance while preserving semantic parity with the English source.
How
bmad-brainstorming,bmad-party-mode,bmad-quick-dev) and ensured Chinese-first related links.Testing
Ran
npm ci && npm run qualitysuccessfully. This includes format checks, linting, markdown linting, docs build, installation component tests, reference validation, and skill validation.Made with Cursor