连接的脉络。把分散的人、工具与信息连成一张可靠的网,让工作在其中顺畅流动,而不是在缝隙里丢失。
智能体会成为每个团队的同事,而不是玩具;信任来自可验证的边界,而不是承诺。我们做的每一件事,都为这个未来铺路。
05 / HOW WE WORK
我们怎样工作
四条原则不写在墙上,写在仓库里。下面每一条旁边,都钉着它在我们仓库里的原文:一条协作规则、几行提交记录、一份变更提案。
工程为先
边界、身份和失败方式先写进契约,其它一切装在这上面。
没有跑过的验证层,不会被写成已通过;没想清楚的边界,不会进主链。功能可以晚一点,地基不能省。
Validation policy / Typed truth and identity
- fmt、OpenSpec validation、source/diff、compile、build/bundle、service migration、App/CU 与生产验收是独立证据层,
- 只报告实际运行且通过的层级。
- 所有 event/action 使用完整 typed identity。unknown、缺失或冲突 identity 必须 fail closed。
- 提交失败不得发布可见语义;投影失败必须传播并从 durable truth 做 typed reconciliation,UI 不合成终态。
仓库根目录的协作规则,每个进来干活的人和 Agent 都先读它。
小步,可回放
每一次变化都是一条小提交,任何一步都能按原路倒回去看。
提交小到一眼能看完,回执带着 commit_seq;出了问题不靠猜,把那一段回放出来。
Kyormar / main
- 166d452chore: 收口当前 Agent 主线基线
- a418205stabilize desktop assistant rendering and resource usage
- bd7ee74fix: 合并活动流与本地显示增量
- b10b62efix: 收口远程集成后的桌面语义冲突
- 8dc6e0dfix: 恢复 rebase 丢失的 UI 集成定义
- 每个 domain 的 hot delivery 与 cold replay 使用同一 commits/projector。
提交信息首字母小写、不用 emoji;热更新与冷回放走同一条提交流。
写下来
决定写成 ADR,边界写进 AGENTS.md,执行留下回执。
文档与代码同一批次发布;评审意见进 PR,不走口头。口头达成的共识,不算共识。
proposal.md / design.md / specs/ / tasks.md
- Why —— Kyormar 的 current architecture 是单仓、受监督同进程 AgentHandle。
- What Changes —— 所有可见状态只来自一个 durable writer:typed command 产生 canonical commit 与单调 commit_seq。
- 文档与代码迁移同一原子发布批次;
- 文档可陈述 canonical contract 和门禁,不能把未运行的层写成已通过。
架构变更先写提案、设计、规格与任务清单,再动代码;完成后归档。
开放与克制
客户端与工具开源,服务端边界公开;没有真实用户证据的功能,宁可不做。
谁都能进来看它怎么工作;顺手就能加的功能,也要先问有没有人在等。危险动作停下等审批,先决定者生效。
Canonical Agent architecture
- 删除旧 Agent transport 后不得保留 compatibility shell、空 feature、dead adapter 或「以后也许用」的旁路。
- 只有具有 production reachability、不可替代安全/持久化职责或已证明用户能力的代码可以保留。
- 只有危险 action 可逐次启动无语义 worker;完成、超时或取消后退出。
- gitee.com/shenzhen-luohuo/Kyormar · shenzhen-luohuo/Kyormar-DevTools
客户端与工具在 Gitee 公开;这条规则决定了哪些代码可以留下。
06 / WHERE WE STAND
站在团队与真实工作之间
我们想成为的,是团队与真实工作系统之间那一层可信的伙伴:向上承接目标、审批与协作,向下管理工具、进程与产出。下面这张图,是我们对自己位置的理解。
07 / IN SHENZHEN
在深圳,做一件慢而认真的事
深圳是一座把想法迅速变成产品的城市:硬件、供应链、软件与设计彼此紧挨着。这种环境让我们养成了务实的习惯,先做出来,再谈概念。
但我们选择在这座快城市里做慢的事:把边界想清楚,把规则写下来,把每一次执行变得可回放。速度来自清晰,而不是来自匆忙。
LET'S TALK
一起把这件慢而认真的事做好
无论是了解络火、探讨合作,还是加入我们,都可以直接写信。工作日 09:00–18:00(北京时间)内回复。


