贡献指南
贡献代码时先保护主闭环：Project、task、proof、review、reward、share pool、memory、Agent readback。
本地环境
bash
pnpm install
cp .env.example .env
pnpm dev单独启动：
bash
pnpm api:dev
pnpm web:dev变更规则
| 改动范围 | 同步检查 |
|---|---|
| Project | Project detail、Workbench、AgentTurn、API readback |
| Validation | launch、task、proof、review、reward、settlement |
| Order | OrderActionPolicy 返回 actions |
| Memory | source、entry、contractHash、agent context |
| Skill | route、execute、verify、project smoke |
| Docs | docs/book、README.md、相关 docs/project-*.md |
PR 门禁
bash
pnpm check
pnpm build
pnpm api:test:unit
pnpm security:secrets
pnpm security:web
git diff --check数据库或 jOOQ 改动增加：
bash
pnpm api:test:integration文档要求
行为变化需要写清：
| 内容 | 要求 |
|---|---|
| 真实入口 | 页面、API、service 或 script |
| 状态流 | old state -> new state |
| 验证命令 | 实际运行的命令 |
| 代码证据 | 文件、类、方法或测试 |
| 用户影响 | 谁会看到变化 |
Agent skill 改动
skills/monopolyfun-agent/ 变更需要覆盖三层：
route-intent识别用户意图和资源
execute-action调用官方 API 写动作
verify-action读取回执并确认落库
Project/OpenClaw 流程还需要运行对应 project smoke，并把持久结论写入 docs/。