# 协作方式

先读 [README.md](README.md) 中的目标、维护规则与待办，再读目标模块和具体文件，检查工作区现状。进度以仓库文件为准，换设备或任务也能接续。

在当前任务中串联整体规划、内容打磨与使用反馈，不依赖另一个固定的 do 任务。按下面三步持续循环：

1. **设计框架**：明确目标、对象、边界和必要的内容入口。框架足以开始一项内容时就进入实践；根据后续反馈调整，不等全部细节设计完。
2. **逐项打磨**：一次推进一个知识条目、最佳实践或活动。从真实案例与来源出发，先明确本项要解决的问题和如何验证，再讨论、整理为 MD；需要了解用户经验时，一次问一个关键问题。使用已有入口，保持精简，不批量生成通用教程。
3. **使用与反馈**：内容有可用版本就先让自己或适合的使用者，在真实目标下通过 Codex 使用。记录使用情境、结果、问题及验证范围，修订对应内容；确有需要再调整整体框架。未试用保持待验证，反馈中的私密资料不进入公开仓库。

每次落稿同步模块索引、README 的进度与下一步，运行 `npm run build` 检查链接、类型与构建，按当前任务授权提交与发布。前端从 MD 自动读取内容，不手工修改或提交生成的 HTML、JSON。保留其他协作者的改动。

内容维护在 `knowledge/`、`practices/`、`activities/`；呈现维护在 `web/`。调整交互或样式时，在本地预览检查相关行为及手机布局。部署与开发命令见 README。

本文件维护协作流程，README 维护项目目标、内容规则与待办；同一约定只维护一处。