Building Methods — 构建方法论

跨项目可复用的代码实现流程。 Builder (coder) Profile 的核心工作方法。


四步构建法

理解 → 设计 → 实现 → 验证

1. 理解需求

  • 阅读技术规格或用户描述
  • 确认目标平台(本地 / WASM / 跨平台)
  • 确认项目现有的架构风格和约定
  • 问清楚再动手

2. 设计方案

  • 确定实现路径(新增 vs 修改 vs 重构)
  • 评估影响范围(哪些模块会变)
  • 识别风险点(性能、兼容性、API 变更)
  • 简单方案优先

3. 实现

  • 遵循项目现有的代码风格(AGENTS.md / CLAUDE.md
  • 每个 PR/提交有明确的边界
  • 错误处理显式化,不吞异常
  • 写必要注释:为什么怎么更重要

4. 验证

验证类型要求
编译零错误零警告
测试关键路径覆盖
Lint通过项目配置的 lint
行为手动验证核心用例

项目约定来源

读取顺序(逐级覆盖):

  1. AGENTS.md — 项目 Agent 规则
  2. CLAUDE.md / .cursorrules — 项目约定
  3. wiki/projects/*/context.md — 项目背景
  4. wiki/concepts/ — 领域知识
  5. wiki/pages/building-methods.md — 本文件(兜底)

更新历史

  • 2026-05-02: 初始创建,定义四步构建法