Developer runs cr js to watch build JavaScript, and yarn vite to start a local server. LLMs edits program by running cr commands, and then triggers re-compiling.
要求查看 Calcit 命令行工具的用法:
cr docs agents --full按需查看 Respo 模块的具体用法:
cr libs readme respo.calcit -f docs/Respo-Agent.md- 先定位再修改：先读结构/需求，再做最小变更，避免“改一处→报错→补救”式迭代。
- 缓存上下文：记录你已经确认的定义位置与修改点，避免重复搜索相同目标。
- 优先局部替换：只替换目标节点或小段结构，避免整段重写导致结构漂移。
- 拆分复杂改动：把 UI 改动与逻辑改动拆开，减少单次变更影响面。
- 尽量复用已有组件/样式：优先扩展已有样式/组件，而不是新增并重复实现。
- 检查生成代码风险点：处理
let、map 结构、属性 map 的键值对等高风险结构时，先确认结构是否符合预期，再替换。 - 利用 diff 控制范围：在多次修改后随时对比 diff，避免无关变更积累。
- 编译前自检：对于复杂变更，先手动检查节点结构（比如嵌套列表、属性 map、函数参数形态）再编译。
- 输出稳定性优先：避免频繁调整格式或样式细节，优先保证逻辑稳定与可读性。
let只保留最后一个表达式：多个表达式需要包一层div/do，否则前面的节点会被丢掉。- 属性 map 必须是成对键值：避免把
:style与:inner-text写在同一个 pair 内；每个属性单独成对。 - 避免生成“可调用字符串”：形如
(<> ((str ...)))会变成调用结果，正确写法为<> $ str ...。 - 列表 vs set：
keys返回 set，拼接前先.to-list，再concat。 - pairs 列表转 map：不要用
.to-map处理 list，改用pairs-map。 - 函数调用与变量区分：
week-start这类变量必须 is-leaf，避免成为单元素 list 导致被当做“函数调用”。 - 数值与单位风险：CSS 属性如
flex,font-weight,line-height,z-index若使用单纯数字，Respo 会自动拼接px单位。必须改为字符串形式，例如:flex "\"1"或:font-weight "\"300"。 - 结构化编辑优先：严禁直接编辑
compact.cirru，必须使用cr tree replace或cr edit def等命令。建议先通过cr query search 'keyword' -f 'ns/def'精确获得 node 路径。 - 性能优化准则：对于动态生成的列表（如任务项），应将静态样式从内联
:style提取到defstyle中，通过:class-name引用以提升虚拟 DOM 性能。 - 排序逻辑翻转：翻转列表排序应直接修改
sort函数所用比较器的返回分支（如将if ret 1 -1翻转为if ret -1 1）。