Menu
在 mbun 项目中开发任何功能或修复缺陷时使用。规定以 bun/node 原生测试集为验收标准的 TDD 开发循环、checkpoint 提交约定与记录流程。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | tdd-workflow |
| description | 在 mbun 项目中开发任何功能或修复缺陷时使用。规定以 bun/node 原生测试集为验收标准的 TDD 开发循环、checkpoint 提交约定与记录流程。 |
mbun 的核心开发约束：bun / node 原生测试集是唯一验收标准，不得为通过测试而修改/弱化原测试语义（compat/ 下的上游语料是只读输入；可以做移植性适配，如路径、运行器桥接，但断言语义必须保持）。
compat/bun/test/ / compat/node/test/parallel/），或为纯逻辑模块圈定行为规范（如从 bun 参考源 compat/bun/src/ 对照移植）。modules/<member>/tests/test_<模块>.cpp（成员目录内 mcpp test 自动发现），引擎级断言可直接翻译上游测试的期望值（参照 modules/html_rewriter/tests/）。mbun test compat/bun/test/<file> 的 pass/fail 为红绿信号（跑法与沙箱见 mbun-runtime-debugging skill）。.agents/skills/mcpp-style-ref/SKILL.md 编码规范（新功能优先独立 workspace 成员 + .cppm 模块），只写让测试通过所需的代码。tools/integration/ 的资源受限沙箱，防 fork/泄漏冻机。<type>(<scope>): <subject>
feat / fix / test / refactor / docs / chore / researchtest(scope): ... 先行，feat(scope): ... 随后）。changelog.md（带测试数据：套件 x/y → x'/y'，0 回归声明要有对照证据）；全量语料测量结果固化到 compat/data/（复现方法见 compat/README.md）；README「兼容性数据」表只放真实测得的数字。compat/ 下上游测试的断言或删除测试用例来「让测试通过」在本仓开发任何改动前用。规定 issue 先行的开发流程,按 bugfix / 优化 / 新功能分流;新功能须经 issue 充分讨论并在 .agents/docs 落地设计方案;衔接 tdd-workflow 与本体验证 / 测试 / CI / PR 规范。开发前先读本 skill。
为 mcpp 项目应用 Modern/Module C++ (C++23) 编码风格。适用于编写或审查带模块的 C++ 代码、命名标识符、组织 .cppm/.cpp 文件，或用户提及 mcpp、module C++、现代 C++ 风格时。
向本仓提交 issue / 发起讨论时用。规定一份好问题反馈的 SOP——软件/版本、报错信息、初步分析、相关资料,并去除本地隐私(用户名/token 等替换)。凡要创建 issue、反馈 bug、发起讨论,先读本 skill 再动手。
调试 mbun 运行时测试失败/崩溃时用。提供仓库实测可用的定位配方——选二进制、单文件跑测、gdb 抓 backtrace、按 API 定位源码、常见坑排查清单、何时跳过。凡处理 bun 测试跑不过/段错误/hang/断言失败，先读本 skill 再动手，避免每个 task 重复摸索拖慢。