Building Methods — 构建方法论
跨项目可复用的代码实现流程。 Builder (coder) Profile 的核心工作方法。
四步构建法
理解 → 设计 → 实现 → 验证
1. 理解需求
- 阅读技术规格或用户描述
- 确认目标平台(本地 / WASM / 跨平台)
- 确认项目现有的架构风格和约定
- 问清楚再动手
2. 设计方案
- 确定实现路径(新增 vs 修改 vs 重构)
- 评估影响范围(哪些模块会变)
- 识别风险点(性能、兼容性、API 变更)
- 简单方案优先
3. 实现
- 遵循项目现有的代码风格(
AGENTS.md/CLAUDE.md) - 每个 PR/提交有明确的边界
- 错误处理显式化,不吞异常
- 写必要注释:为什么比怎么更重要
4. 验证
| 验证类型 | 要求 |
|---|---|
| 编译 | 零错误零警告 |
| 测试 | 关键路径覆盖 |
| Lint | 通过项目配置的 lint |
| 行为 | 手动验证核心用例 |
项目约定来源
读取顺序(逐级覆盖):
AGENTS.md— 项目 Agent 规则CLAUDE.md/.cursorrules— 项目约定wiki/projects/*/context.md— 项目背景wiki/concepts/— 领域知识wiki/pages/building-methods.md— 本文件(兜底)
更新历史
- 2026-05-02: 初始创建,定义四步构建法