Imported from xxxxxxxxcccccccc/CH32V203-FreeRTOS-BalanceCar (
AGENTS.md). Install upstream withnpx skills add xxxxxxxxcccccccc/CH32V203-FreeRTOS-BalanceCar. Copyright stays with the author.
项目入口
这是一个使用 Trellis 框架管理的项目。
项目概述
基于 CH32V203(沁恒 WCH,RISC-V 内核)MCU 的嵌入式工程,使用 FreeRTOS 实时操作系统。
业务代码位于 User/,外设库在 Peripheral/,内核在 FreeRTOS/。
工具链为 RISC-V GCC(MounRiver Studio 工程)。详见 .trellis/spec/coding-standards.md。
关键目录
.trellis/spec/- 项目规范和编码标准.trellis/tasks/- 当前和历史任务.trellis/workspace/- 工作日志和会话记录.trellis/scripts/- 辅助脚本工具
工作流程
开始工作(每次会话开始时)
-
读取项目概况
# 查看项目上下文(最重要!) python "./.trellis/scripts/get_context.py" --mode record这会显示:
- 当前任务
- 最新进度(最新的session文件)
- 项目根目录
-
查看任务列表
python "./.trellis/scripts/task.py" list -
阅读相关文件
- 最新的
.trellis/workspace/YYYY-MM-DD-session-N.md - 相关的
.trellis/spec/规范文件 - 任务的
.trellis/tasks/[task-name]/README.md
- 最新的
完成工作(每次会话结束时)
-
创建新的会话记录
python "./.trellis/scripts/get_context.py" --mode record-session这会自动创建一个新的session文件模板
-
填写会话记录
- 记录本次完成的工作
- 记录创建/修改的文件
- 记录遇到的问题和解决方案
- 记录下一步计划
-
提交代码(如果需要)
git add . git commit -m "描述本次工作"
当前任务
使用以下命令查看:
python "./.trellis/scripts/task.py" list
最新进度
查看 .trellis/workspace/ 目录下的最新 journal 文件。
注意事项
- 仓库里的事实永远优先于 AI 的记忆
- 正式写代码前必须先读相关 spec
- 每次工作结束后要执行 record-session
- 长期规则要用 update-spec 沉淀到 spec 中
