先读 README.md 中的目标、维护规则与待办,再读目标模块和具体文件,检查工作区现状。进度以仓库文件为准,换设备或任务也能接续。
在当前任务中串联整体规划、内容打磨与使用反馈,不依赖另一个固定的 do 任务。按下面三步持续循环:
- 设计框架:明确目标、对象、边界和必要的内容入口。框架足以开始一项内容时就进入实践;根据后续反馈调整,不等全部细节设计完。
- 逐项打磨:一次推进一个知识条目、最佳实践或活动。从真实案例与来源出发,先明确本项要解决的问题和如何验证,再讨论、整理为 MD;需要了解用户经验时,一次问一个关键问题。使用已有入口,保持精简,不批量生成通用教程。
- 使用与反馈:内容有可用版本就先让自己或适合的使用者,在真实目标下通过 Codex 使用。记录使用情境、结果、问题及验证范围,修订对应内容;确有需要再调整整体框架。未试用保持待验证,反馈中的私密资料不进入公开仓库。
每次落稿同步模块索引、README 的进度与下一步,运行 npm run build 检查链接、类型与构建,按当前任务授权提交与发布。前端从 MD 自动读取内容,不手工修改或提交生成的 HTML、JSON。保留其他协作者的改动。
内容维护在 knowledge/、practices/、activities/;呈现维护在 web/。调整交互或样式时,在本地预览检查相关行为及手机布局。部署与开发命令见 README。
本文件维护协作流程,README 维护项目目标、内容规则与待办;同一约定只维护一处。