@haaaiawd/skeinn 0.0.0-stage → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +90 -0
- package/CONTRIBUTING.md +37 -0
- package/EVIL_EVAL.md +84 -0
- package/LICENSE +21 -0
- package/README.md +164 -2
- package/README.zh-CN.md +229 -0
- package/SECURITY.md +11 -0
- package/cli/bin/skeinn.js +497 -0
- package/cli/src/protocol.js +797 -0
- package/cli/src/store.js +1554 -0
- package/design.md +230 -0
- package/docs/PROMPT_CATALOG.md +139 -0
- package/docs/RELEASE_CHECKLIST.md +53 -0
- package/docs/UX_FLOW.md +188 -0
- package/docs/ai-development-landscape-2026-10.md +163 -0
- package/docs/brand/skeinn-mark-dark.svg +14 -0
- package/docs/brand/skeinn-mark.svg +14 -0
- package/docs/brand/skeinn-wordmark-dark.svg +11 -0
- package/docs/brand/skeinn-wordmark-light.svg +11 -0
- package/docs/loom-eval-loop.drawio +21 -0
- package/docs/loom-eval-loop.svg +56 -0
- package/docs/loom-journey-audit.md +107 -0
- package/docs/loom-production-loop.drawio +41 -0
- package/docs/loom-production-loop.svg +92 -0
- package/package.json +54 -4
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
# 2026 年 AI 开发方法对照:LOOM 缺在哪里
|
|
2
|
+
|
|
3
|
+
检索日:2026-10-18。用户关注的时间范围:2026 年下半年,当前已发生的部分为 2026-07-01 至 2026-10-18。本报告检查当日可访问的官方资料;较早发表但仍有参考价值的工程方法明确注明日期,不把它们称为下半年新发明。
|
|
4
|
+
|
|
5
|
+
本轮使用 Exa 做了 10 次成功检索,返回 47 条候选结果,并通过官方仓库、官方文档及原作者工程文章核对机制。47 是检索结果条数,含重复,不是 47 个独立验证来源。比较选择五个社区框架、一个集成产品和一组厂商工程方法,覆盖规范驱动、开发纪律、上下文、既有仓库、生命周期与宿主集成。社区规模、持续维护和官方工程经验是入选信号,不是市场占有率或效果排行。
|
|
6
|
+
|
|
7
|
+
**结论:LOOM 的理解与连续性方向成立。相较这些方法,主要缺口在于按情景选择最少必要流程、让当前事实与旧证据持续对齐、控制恢复成本,以及让检查真正连接运行结果。** 增加角色、模板和文档数量,并不能补齐这些缺口。
|
|
8
|
+
|
|
9
|
+
## 1. 哪些方法值得对照
|
|
10
|
+
|
|
11
|
+
### GitHub Spec Kit:规范到实现的再收敛
|
|
12
|
+
|
|
13
|
+
官方当前 SDD 路径包含 constitution、specify、plan、tasks、implement、converge,也有 clarify、checklist、analyze。analyze 面向规范、计划和任务之间的一致性;converge 在实现后寻找未兑现部分,补任务后继续实现。当前仓库还将修 bug、判断想法作为不同入口,不宜只用早期“线性 SDD 模板”概括它。
|
|
14
|
+
|
|
15
|
+
借鉴点:交付前重新核对承诺有没有兑现,不能只数任务勾选。限制:模型做一致性检查不等于执行验证;官方列出机制也不证明其实际收益。
|
|
16
|
+
|
|
17
|
+
来源:[官方仓库](https://github.com/github/spec-kit)、[SDD Quickstart](https://github.github.com/spec-kit/quickstart.html)。
|
|
18
|
+
|
|
19
|
+
### OpenSpec:以一次变更为单位维护当前规范
|
|
20
|
+
|
|
21
|
+
它区分当前规范与进行中的 change,后者有 proposal、delta specs、design、tasks。实施中可以改规划,完成后 sync/archive。一次急修可成为另一个 change,之后返回原变更。这里值得学习的是变化的边界和闭合位置。
|
|
22
|
+
|
|
23
|
+
限制:官方明确 verify 不阻止 archive,未完成任务也可以仅警告。因此不能把 OpenSpec 描述成自动保证交付完整或强事务系统。不同 agent action 与 CLI archive 路径的同步行为也有区别。
|
|
24
|
+
|
|
25
|
+
来源:[官方仓库](https://github.com/Fission-AI/OpenSpec)、[官方 Workflows](https://raw.githubusercontent.com/Fission-AI/OpenSpec/main/docs/workflows.md)。
|
|
26
|
+
|
|
27
|
+
### BMAD Method:当前文档比旧印象轻
|
|
28
|
+
|
|
29
|
+
当前官方允许很小的低风险编辑跳过框架;Build 根据意图缺口、不可逆动作和影响范围选择轻重路径。存量仓库以代码为主要事实源,保留真正难发现的约束。新的 project-context 支持 adopt、refresh、record、audit,旧 document-project 已弃用。
|
|
30
|
+
|
|
31
|
+
借鉴点:不是为所有项目准备相同文件,而是补当前工作缺失的理解。限制:它仍有显著的工作流、角色和维护成本;其人类审批方式不必照搬到“LOOM 对用户不可见”的产品目标。
|
|
32
|
+
|
|
33
|
+
来源:[Build a Change](https://docs.bmad-method.org/build/build-a-change/)、[存量仓库入口](https://docs.bmad-method.org/existing-codebases/start-in-an-existing-codebase/)、[上下文维护](https://docs.bmad-method.org/existing-codebases/set-and-maintain-project-context/)、[规划尺度](https://docs.bmad-method.org/plan/choose-a-planning-path/)。
|
|
34
|
+
|
|
35
|
+
### Superpowers:把工程纪律做成可触发的技能
|
|
36
|
+
|
|
37
|
+
它将澄清、计划、执行、调试、代码审查和收尾组织成技能。verification-before-completion 特别要求成功声明之前运行并读取新鲜验证结果。它的价值是缩短“应该验证”和“实际做验证”的距离。
|
|
38
|
+
|
|
39
|
+
限制:技能指令仍靠宿主遵循,并不是独立的真实性证明。强 TDD、很细的任务和频繁审查也不适用于所有文字、运维、探索工作。
|
|
40
|
+
|
|
41
|
+
来源:[官方仓库](https://github.com/obra/superpowers)、[完成前验证技能](https://github.com/obra/superpowers/blob/HEAD/skills/verification-before-completion/SKILL.md)。
|
|
42
|
+
|
|
43
|
+
### GSD / GSD Core:把非理想路径纳入日常操作
|
|
44
|
+
|
|
45
|
+
检索确认旧 gsd-build/get-shit-done 仓库已归档并指向 open-gsd/gsd-core。当前文档有既有仓库 onboard、pause/resume、工作范围调整、状态诊断、升级后本地修改恢复,也强调为新上下文准备可执行工作单元。
|
|
46
|
+
|
|
47
|
+
借鉴点:暂停、恢复、升级和自定义文件保留是产品路径,不应全靠 Agent 临场补救。限制:多运行时适配和大量命令也带来复杂度。部分机制来自当前 next 分支文档,未逐项安装验证,也不承诺 npm 稳定版包含同样行为;新旧仓库的关注量不能相加当用户数。
|
|
48
|
+
|
|
49
|
+
来源:[旧仓库迁移声明](https://github.com/gsd-build/get-shit-done)、[GSD Core](https://github.com/open-gsd/gsd-core)、[当前用户指南](https://github.com/open-gsd/gsd-core/blob/next/docs/USER-GUIDE.md)。
|
|
50
|
+
|
|
51
|
+
### Kiro:事件能把规则接到执行时刻
|
|
52
|
+
|
|
53
|
+
Hooks 支持在会话、工具或任务事件触发 shell 命令或 Agent 提示;PreToolUse 可进行前置校验。它说明持续性规则可以由宿主事件唤起,不必每次等模型自己想起。
|
|
54
|
+
|
|
55
|
+
限制:表面/版本支持不同;文件事件只响应 Agent 的文件修改,不响应人类手动编辑。因此 hooks 不能替代恢复时核对仓库差异,也不是所有命令自动成功。
|
|
56
|
+
|
|
57
|
+
来源:[官方 Hooks](https://kiro.dev/docs/hooks/)、[事件与支持范围](https://kiro.dev/docs/hooks/types/)。检索标注该文档更新于 2026-10-10。
|
|
58
|
+
|
|
59
|
+
### Anthropic 的 harness 工程方法:只保留仍然有用的脚手架
|
|
60
|
+
|
|
61
|
+
2026-03-24 的长程开发实验使用规划、生成和评价,在运行中的应用上检查结果;作者也报告评价者会漏错、会错误放行。换更强模型后,一些分解和逐轮评价可被移除。2026-04-02 的文章继续强调检查哪些约束已不再必要。
|
|
62
|
+
|
|
63
|
+
借鉴点:评价要接触真实结果,流程要随模型和任务难度变化。限制:这些是具体团队与任务上的工程实验,不是证明所有 Agent 都应采用同样架构的通用基准。
|
|
64
|
+
|
|
65
|
+
来源:[Harness design for long-running application development](https://www.anthropic.com/engineering/harness-design-long-running-apps)、[3 patterns for harness design](https://claude.com/resources/articles/harnessing-claudes-intelligence)。
|
|
66
|
+
|
|
67
|
+
## 2. 回到 LOOM:八个具体不足
|
|
68
|
+
|
|
69
|
+
以下是结合外部机制和本地证据的判断,并非外部作者对 LOOM 的评价。
|
|
70
|
+
|
|
71
|
+
### A. 流程重量主要由 Agent 自觉调整,项目入口缺少相应支持
|
|
72
|
+
|
|
73
|
+
LOOM 已明确反对固定问卷、无必要测试和通用软件模板。但 `markReady`(store.js:798)仍统一要求真实 PROJECT、至少一个设计文档和非空任务图。任务级的 design/capability exemption 不能替代项目级的轻入口。
|
|
74
|
+
|
|
75
|
+
对照 BMAD、Spec Kit 不同入口,缺口不在理念,而在能否让实现支持理念。一次明确低风险修复,不应为了过同一道项目门槛补出虚假的“完整设计”。
|
|
76
|
+
|
|
77
|
+
建议:按不确定性、影响范围和可逆性路由为直接处理、一次变更、跨阶段项目;三者共用相同诚实证据原则,按需扩大上下文。不要另造三套重复框架。
|
|
78
|
+
|
|
79
|
+
### B. 接入现有仓库偏脚手架,缺少事实校准和维护入口
|
|
80
|
+
|
|
81
|
+
上一轮 P01 证实 init 保留源码和已有规则,但 PROJECT 仍是模板。`installAgentAnchor`(146)追加固定协议,不能判断已存在指令的适用性,也无 adopt/refresh/audit 路径。
|
|
82
|
+
|
|
83
|
+
BMAD 当前实践尤其提醒我们:不要为“理解项目”复制一遍代码中能直接发现的信息。LOOM 的 PROJECT 和 STRUCTURE 有明确的地图价值,应保留;需要减少的是重复说明和无来源的概括。
|
|
84
|
+
|
|
85
|
+
建议:接入只建立与本次任务有关的可信基线;记录难重建的意图、例外、运行前提和错误教训。保留来源与最近核对位置;常规技术事实尽量指向配置和代码。
|
|
86
|
+
|
|
87
|
+
### C. 变更有日志,没有完整的影响与闭合机制
|
|
88
|
+
|
|
89
|
+
LOOM 有 decision、affected_tasks、update/reopen,并非不能处理演化。但影响对象由 Agent 手填,完成后的依赖失效不自动显现。上一轮 P06:上游重开为 open,下游仍 done,check 没有相关警告。
|
|
90
|
+
|
|
91
|
+
从 OpenSpec 借的应是一次变更的明确边界:为什么改、修改哪些当前承诺、旧证据哪些还有效、何时闭合。无需照搬它的目录,也不能声称它自动解决语义依赖。
|
|
92
|
+
|
|
93
|
+
建议:构建轻量变更记录连接既有 decision 与 tasks,给依赖闭包标注待复核;Agent 判断实质影响,无影响则保留,有影响再重验。取消与缩小范围也需要正式出口。
|
|
94
|
+
|
|
95
|
+
### D. 验证承诺强,证据与现实的绑定仍弱
|
|
96
|
+
|
|
97
|
+
LOOM 完成任务需要逐项 evidence,并校验本地输出存在,这是已有优点。问题是 evidence 仍是文本,CLI 无法知道其是否来自本次运行、哪个版本、什么环境。上一轮 P07 还表明,存在未覆盖交付时项目可 complete,check 可 healthy=true。
|
|
98
|
+
|
|
99
|
+
借鉴 Spec Kit converge、Superpowers 和 Anthropic 运行中评价:完成前需要一次跨层核对。Keeper 检查首次可交接性;它不能替代结果验收。LOOM 已能用普通 Task 做阶段审查,缺的是默认触发条件与可追溯证据,而不是再创一个角色。
|
|
100
|
+
|
|
101
|
+
建议:对高风险或跨组件交付,记录验证命令/观察方法、退出码、日志/截图引用、代码或输入摘要、范围和时间。外部人工验证仍允许,但来源要诚实。把结构健康、任务完成、交付覆盖和真实结果分开报告。
|
|
102
|
+
|
|
103
|
+
### E. 上下文聚焦只控制任务选择,尚未控制输入体积
|
|
104
|
+
|
|
105
|
+
`compileContext`(928–993)总是加入协议、PROJECT、STRUCTURE;active 时再加执行协议和全部 reads 文件。当前没有整体预算、分层按需取用或体积预警;STRUCTURE 如在 reads 中会重复加入。
|
|
106
|
+
|
|
107
|
+
本轮 TASK-016 的实测输出为 156,362 字符,其中通用协议 10,560、执行协议 5,519;store.js 68,156、protocol.js 45,718;STRUCTURE 注入两次。它是本轮广范围审查的压力例子,不代表普通任务平均值,也没有将字符数冒充 token 数。
|
|
108
|
+
|
|
109
|
+
对照 BMAD 的上下文精简和 GSD 的工作单元设计,LOOM 需要证明“选择了相关文件”之外的效果:恢复时能否保留关键限制,同时减少重复和无关内容。
|
|
110
|
+
|
|
111
|
+
建议:最小恢复包给出当前意图、任务、风险和精确引用;细节按需读取,支持可追溯的节选或节点,不静默截断。先做去重、字符体积分解和大输入警告,再决定是否需要复杂检索。
|
|
112
|
+
|
|
113
|
+
### F. 暂停、升级、损坏恢复没有完成产品化
|
|
114
|
+
|
|
115
|
+
状态仅 open/active/blocked/done;没有 pause/cancel,临时插队借用 block。P02 表明重复 init 不同步锚点,P03 表明已存在 state 时 init 不修复损坏 tasks,P09 表明 check 不识别普通锚点丢失。state 仅记录 schema,缺少 CLI/protocol 来源关系。
|
|
116
|
+
|
|
117
|
+
GSD 的文档直接展示了这些路径的重要性。LOOM 不必复制几十个命令,但需要让 Agent 有明确的诊断、保存、恢复和验证步骤。
|
|
118
|
+
|
|
119
|
+
建议:优先做只读诊断和可审阅同步;保留升级前快照与自定义锚点外内容;恢复时核对代码、状态、协议三者。单文件 atomic rename 不是多文件事务,并发能力仍需单独设计。
|
|
120
|
+
|
|
121
|
+
### G. “不可见基础设施”尚缺宿主能力适配
|
|
122
|
+
|
|
123
|
+
当前依赖 AGENTS 提醒 Agent 在边界运行 context,没有会话/停止/工具事件的适配契约。初次 Keeper 的隔离由宿主负责,sidecar 参数也要宿主持续传入。
|
|
124
|
+
|
|
125
|
+
Kiro 的事件式操作给出一种可选机制。但 LOOM 的可移植性有价值,不应为了 hooks 绑定某 IDE。
|
|
126
|
+
|
|
127
|
+
建议:保留 CLI 核心,定义宿主可提供哪些事件、独立执行环境、检查结果与工作区身份;有能力时自动接入,没有时明确使用提示协议。只在有意义边界触发,不在每次保存时重新注入全部上下文。
|
|
128
|
+
|
|
129
|
+
### H. 框架新增机制还没有足够的边际收益证据
|
|
130
|
+
|
|
131
|
+
不能说 LOOM 没有评估。EVIL_EVAL.md 已规定等模型、等信息、等预算、重复、盲评和消融;pilot-001 也实际做过比较。结果记录坦诚说明:每条件仅一次,预算未计量、干预不对称、评审包曾损坏,因此只有方向性观察,不能证明普遍收益。live-use 同样是单次观察。
|
|
132
|
+
|
|
133
|
+
这与 Anthropic 随模型能力删除脚手架的做法呼应。我们现在最缺的不是再写一份评估原则,而是执行已写下的原则,并将模型版本纳入复查条件。
|
|
134
|
+
|
|
135
|
+
建议:同模型/预算比较普通 Agent、最小 PROJECT+Task、完整 LOOM;先测现仓接入、途中改意图、暂停恢复三个场景,每条件至少三次。观测结果正确性、漏验率、用户负担、耗时、token 和文档维护量。首轮不要同时给多家框架全套配平,否则实验成本先失控;最小 LOOM 若已有效,再加入最贴近的外部方法基线。
|
|
136
|
+
|
|
137
|
+
## 3. 哪些差异应该保留
|
|
138
|
+
|
|
139
|
+
LOOM 的自然交流、当前整体入口、专业判断卷宗、能力节点与任务的连接、跨上下文可追溯性,仍是值得保留和测试的组合。不能因其他项目关注量更大,就把它们都改成软件 PRD 或固定角色接力。
|
|
140
|
+
|
|
141
|
+
不建议照搬:每任务强制新 Agent、全场景 TDD、固定数量的小任务、默认工作树/提交、所有小改都写规范、角色越多越专业,以及把 CLI 绿色或 LLM 审查判决当真实完成。
|
|
142
|
+
|
|
143
|
+
更值得形成的定位是:**在目标和环境不断变化时,为 Agent 保存最少且足够、能查到来源、知道何时要重验的项目判断。** 它比“让 Agent 更认真规划”更具体,也更容易被实验推翻或证实。
|
|
144
|
+
|
|
145
|
+
## 4. 建议下一轮按什么顺序验证
|
|
146
|
+
|
|
147
|
+
1. **完成和变化的可信度**:复现 P06/P07;上游变化应让相关下游进入待复核,未覆盖交付不应被展示成结果已交付;证据能指向对应输入和版本。对无影响任务不强制重做。
|
|
148
|
+
2. **最小恢复与轻重路由**:去重并量化 context;分别测试微修、普通变更、长期项目。成功标准是关键限制保留、用户额外操作减少、总体成本下降,不是文件更少。
|
|
149
|
+
3. **现仓与升级路径**:在有自定义 AGENTS、有未提交代码的仓库接入;模拟协议版本不同、暂停插队、JSON 损坏。要求不覆盖原规则、不制造双真相、能给出可执行恢复出口。
|
|
150
|
+
4. **跑消融而非继续累加**:把上述候选机制逐个加入最小 LOOM,看收益是否仍成立。没有收益就删减,不因为已经实现而保留。
|
|
151
|
+
|
|
152
|
+
## 本地证据入口
|
|
153
|
+
|
|
154
|
+
- `docs/loom-journey-audit.md`:上一轮 38 个情景及 12 个隔离探针的解释。
|
|
155
|
+
- `tmp/loom-journey-probe-results.json`:P01–P12 的原始观察,本轮引用既有结果,未称重新运行。
|
|
156
|
+
- `cli/src/store.js`:当前实现;行号均为本轮定位。
|
|
157
|
+
- `EVIL_EVAL.md`:已有因果比较协议。
|
|
158
|
+
- `evals/pilot-001/PILOT_RESULT.md`:方向性试验与混杂因素。
|
|
159
|
+
- `evals/live-use-001/ROOT_REVIEW.md`:早期单次实用观察;若干缺陷已修,不将旧发现一概当作当前缺陷。
|
|
160
|
+
|
|
161
|
+
## 不确定性
|
|
162
|
+
|
|
163
|
+
未安装或端到端运行这些外部框架;官方功能描述与源码/技能约定不等于实际效果。当前 mutable 文档不是锁定版本;某些早期索引与官方新文档冲突时,以新官方入口为准并保留限制。此次未覆盖所有流行工具,也未对任何框架给出全面优劣或市场份额结论。本轮仅交付研究与建议,没有修改 LOOM 运行时。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="256" height="256" viewBox="0 0 256 256" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">Skeinn mark (dark)</title>
|
|
3
|
+
<desc id="desc">Two symmetric open arcs framing a central four-point electric cobalt core on obsidian.</desc>
|
|
4
|
+
<rect x="4" y="4" width="248" height="248" rx="58" fill="#0F1011" stroke="#26282E" stroke-width="2"/>
|
|
5
|
+
<!-- Left continuity arc -->
|
|
6
|
+
<path d="M 107 63.3 A 68 68 0 0 0 88 183"
|
|
7
|
+
fill="none" stroke="#F7F8F8" stroke-width="24" stroke-linecap="round"/>
|
|
8
|
+
<!-- Right continuity arc (180-deg rotational symmetry) -->
|
|
9
|
+
<path d="M 149 192.7 A 68 68 0 0 0 168 73"
|
|
10
|
+
fill="none" stroke="#F7F8F8" stroke-width="24" stroke-linecap="round"/>
|
|
11
|
+
<!-- Central electric cobalt core -->
|
|
12
|
+
<path d="M 128 102 Q 132 124 154 128 Q 132 132 128 154 Q 124 132 102 128 Q 124 124 128 102 Z"
|
|
13
|
+
fill="#4D7CFE"/>
|
|
14
|
+
</svg>
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="256" height="256" viewBox="0 0 256 256" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">Skeinn mark</title>
|
|
3
|
+
<desc id="desc">Two symmetric open arcs framing a central four-point cobalt core.</desc>
|
|
4
|
+
<rect x="4" y="4" width="248" height="248" rx="58" fill="#F5F4EF" stroke="#E2DFD5" stroke-width="2"/>
|
|
5
|
+
<!-- Left continuity arc -->
|
|
6
|
+
<path d="M 107 63.3 A 68 68 0 0 0 88 183"
|
|
7
|
+
fill="none" stroke="#17212B" stroke-width="24" stroke-linecap="round"/>
|
|
8
|
+
<!-- Right continuity arc (180-deg rotational symmetry) -->
|
|
9
|
+
<path d="M 149 192.7 A 68 68 0 0 0 168 73"
|
|
10
|
+
fill="none" stroke="#17212B" stroke-width="24" stroke-linecap="round"/>
|
|
11
|
+
<!-- Central cobalt core -->
|
|
12
|
+
<path d="M 128 102 Q 132 124 154 128 Q 132 132 128 154 Q 124 132 102 128 Q 124 124 128 102 Z"
|
|
13
|
+
fill="#3B63F6"/>
|
|
14
|
+
</svg>
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="380" height="88" viewBox="0 0 380 88" role="img" aria-labelledby="title">
|
|
2
|
+
<title id="title">Skeinn</title>
|
|
3
|
+
<!-- Distilled 3-element mark (no card, transparent background for dark mode) -->
|
|
4
|
+
<g transform="translate(8 8) scale(0.28125)">
|
|
5
|
+
<path d="M 107 63.3 A 68 68 0 0 0 88 183" fill="none" stroke="#F7F8F8" stroke-width="26" stroke-linecap="round"/>
|
|
6
|
+
<path d="M 149 192.7 A 68 68 0 0 0 168 73" fill="none" stroke="#F7F8F8" stroke-width="26" stroke-linecap="round"/>
|
|
7
|
+
<path d="M 128 100 Q 132.5 123.5 156 128 Q 132.5 132.5 128 156 Q 123.5 132.5 100 128 Q 123.5 123.5 128 100 Z" fill="#4D7CFE"/>
|
|
8
|
+
</g>
|
|
9
|
+
<!-- Clean geometric wordmark -->
|
|
10
|
+
<text x="98" y="61" font-family="Inter, -apple-system, BlinkMacSystemFont, Segoe UI, Arial, sans-serif" font-size="52" font-weight="700" letter-spacing="-1.2" fill="#F7F8F8">Skeinn</text>
|
|
11
|
+
</svg>
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="380" height="88" viewBox="0 0 380 88" role="img" aria-labelledby="title">
|
|
2
|
+
<title id="title">Skeinn</title>
|
|
3
|
+
<!-- Distilled 3-element mark (no card, transparent background) -->
|
|
4
|
+
<g transform="translate(8 8) scale(0.28125)">
|
|
5
|
+
<path d="M 107 63.3 A 68 68 0 0 0 88 183" fill="none" stroke="#17212B" stroke-width="26" stroke-linecap="round"/>
|
|
6
|
+
<path d="M 149 192.7 A 68 68 0 0 0 168 73" fill="none" stroke="#17212B" stroke-width="26" stroke-linecap="round"/>
|
|
7
|
+
<path d="M 128 100 Q 132.5 123.5 156 128 Q 132.5 132.5 128 156 Q 123.5 132.5 100 128 Q 123.5 123.5 128 100 Z" fill="#3B63F6"/>
|
|
8
|
+
</g>
|
|
9
|
+
<!-- Clean geometric wordmark -->
|
|
10
|
+
<text x="98" y="61" font-family="Inter, -apple-system, BlinkMacSystemFont, Segoe UI, Arial, sans-serif" font-size="52" font-weight="700" letter-spacing="-1.2" fill="#17212B">Skeinn</text>
|
|
11
|
+
</svg>
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
<mxfile host="app.diagrams.net" modified="2026-08-09T22:30:00.000Z" agent="Codex" version="24.7.17">
|
|
2
|
+
<diagram id="loom-eval" name="LOOM Evil Eval">
|
|
3
|
+
<mxGraphModel dx="1600" dy="860" grid="1" gridSize="10" guides="1" page="1" pageScale="1" pageWidth="1600" pageHeight="860"><root><mxCell id="0"/><mxCell id="1" parent="0"/>
|
|
4
|
+
<mxCell id="title" value="The Evil Eval: does LOOM cause the gain?" style="text;html=1;fontSize=28;fontStyle=1;fontColor=#17212B;align=left;" vertex="1" parent="1"><mxGeometry x="70" y="30" width="900" height="50" as="geometry"/></mxCell>
|
|
5
|
+
<mxCell id="controls" value="FREEZE EVERYTHING EXCEPT THE TREATMENT<br>same model · same tools · same workspace · same hidden user facts · same budget · same reset schedule · ≥ 3 repeats" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#17212B;strokeColor=#17212B;fontColor=#F5F2EA;fontStyle=1;align=left;spacingLeft=24;" vertex="1" parent="1"><mxGeometry x="70" y="110" width="1460" height="90" as="geometry"/></mxCell>
|
|
6
|
+
<mxCell id="a-band" value="A · BASELINE — Normal Agent, no LOOM" style="swimlane;horizontal=1;startSize=52;rounded=1;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#C7C2B8;fontColor=#58636D;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="70" y="240" width="700" height="270" as="geometry"/></mxCell>
|
|
7
|
+
<mxCell id="b-band" value="B · TREATMENT — Same Agent, LOOM available" style="swimlane;horizontal=1;startSize=52;rounded=1;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#4169E1;fontColor=#4169E1;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="830" y="240" width="700" height="270" as="geometry"/></mxCell>
|
|
8
|
+
<mxCell id="a1" value="<b>Shape project</b><br>questions · decisions<br>plans · documents" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="105" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="a2" value="<b>Force reset</b><br>after shaping<br>and mid-Task" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="330" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="a3" value="<b>Fresh Agent</b><br>continue from disk<br>build vertical slice" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="555" y="335" width="175" height="85" as="geometry"/></mxCell>
|
|
9
|
+
<mxCell id="b1" value="<b>Shape with LOOM</b><br>same brief and Agent<br>treatment only" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="865" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="b2" value="<b>Force reset</b><br>identical timing<br>identical budget" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="1090" y="335" width="175" height="85" as="geometry"/></mxCell><mxCell id="b3" value="<b>Fresh Agent</b><br>use LOOM disk truth<br>build vertical slice" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8ECFA;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1315" y="335" width="175" height="85" as="geometry"/></mxCell>
|
|
10
|
+
<mxCell id="ae1" edge="1" source="a1" target="a2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="ae2" edge="1" source="a2" target="a3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="be1" edge="1" source="b1" target="b2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="be2" edge="1" source="b2" target="b3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
|
|
11
|
+
<mxCell id="collect-a" value="COLLECT · questions · docs · code · tests · time · tokens · user burden" style="text;html=1;fontSize=11;fontColor=#58636D;align=left;" vertex="1" parent="1"><mxGeometry x="105" y="450" width="610" height="30" as="geometry"/></mxCell><mxCell id="collect-b" value="COLLECT · the same artifact classes, under the same stopping rule" style="text;html=1;fontSize=11;fontColor=#58636D;align=left;" vertex="1" parent="1"><mxGeometry x="865" y="450" width="610" height="30" as="geometry"/></mxCell>
|
|
12
|
+
<mxCell id="judge" value="BLIND PAIRWISE JUDGE<br><b>Anonymize → randomize → swap order</b><br>Preflight the packet; repeat ≥ 3" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="590" y="560" width="420" height="105" as="geometry"/></mxCell>
|
|
13
|
+
<mxCell id="aj" edge="1" source="a-band" target="judge" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="bj" edge="1" source="b-band" target="judge" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
|
|
14
|
+
<mxCell id="score" value="<b>SCORE NET VALUE</b><br>intent · question value · buildability<br>continuity · burden · cost · ceremony" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="120" y="720" width="280" height="85" as="geometry"/></mxCell>
|
|
15
|
+
<mxCell id="gain" value="Reliable net gain across repeats?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="520" y="710" width="230" height="105" as="geometry"/></mxCell>
|
|
16
|
+
<mxCell id="yes" value="YES · ABLATE<br><b>Find the causal mechanism</b><br>keep only what creates the gain" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;" vertex="1" parent="1"><mxGeometry x="870" y="720" width="250" height="85" as="geometry"/></mxCell>
|
|
17
|
+
<mxCell id="no" value="NO · BE EVIL<br><b>Simplify, revise, or delete</b><br>ceremony gets no sympathy" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="1230" y="720" width="250" height="85" as="geometry"/></mxCell>
|
|
18
|
+
<mxCell id="js" edge="1" source="judge" target="score" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="sg" edge="1" source="score" target="gain" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="gy" value="yes" edge="1" source="gain" target="yes" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="gn" value="no" edge="1" source="gain" target="no" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="635" y="835"/><mxPoint x="1355" y="835"/></Array></mxGeometry></mxCell>
|
|
19
|
+
</root></mxGraphModel>
|
|
20
|
+
</diagram>
|
|
21
|
+
</mxfile>
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" width="1600" height="860" viewBox="0 0 1600 860" role="img" aria-labelledby="title desc">
|
|
2
|
+
<title id="title">LOOM Evil Eval</title>
|
|
3
|
+
<desc id="desc">A controlled comparison between the same capable Agent without a framework and with LOOM, followed by blinded judging and ablation.</desc>
|
|
4
|
+
<defs>
|
|
5
|
+
<marker id="a" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#17212B"/></marker>
|
|
6
|
+
<marker id="ba" markerWidth="10" markerHeight="10" refX="8" refY="5" orient="auto"><path d="M0 0 10 5 0 10Z" fill="#4169E1"/></marker>
|
|
7
|
+
<style>text{font-family:Inter,Segoe UI,Arial,sans-serif;fill:#17212B}.title{font-size:34px;font-weight:760}.subtitle{font-size:16px;fill:#58636D}.eyebrow{font-size:11px;font-weight:760;letter-spacing:1.35px}.h{font-size:16px;font-weight:720}.body{font-size:12px;fill:#58636D}.small{font-size:11px;font-weight:690}.inverse{fill:#F5F2EA}.mint{fill:#9AD8C2}.edge{fill:none;stroke:#17212B;stroke-width:2.2;marker-end:url(#a)}.feedback{fill:none;stroke:#4169E1;stroke-width:2.3;stroke-dasharray:7 7;marker-end:url(#ba)}</style>
|
|
8
|
+
</defs>
|
|
9
|
+
<rect width="1600" height="860" fill="#F5F2EA"/>
|
|
10
|
+
<text class="title" x="70" y="62">The Evil Eval: does LOOM cause the gain?</text>
|
|
11
|
+
<text class="subtitle" x="70" y="92">Primary comparison: the same capable Agent, with and without the framework—not LOOM 2 versus its weaker ancestor.</text>
|
|
12
|
+
|
|
13
|
+
<rect x="70" y="128" width="1460" height="92" rx="20" fill="#17212B"/>
|
|
14
|
+
<text class="eyebrow mint" x="98" y="158">FREEZE EVERYTHING EXCEPT THE TREATMENT</text>
|
|
15
|
+
<g font-family="ui-monospace,SFMono-Regular,Consolas,monospace" font-size="13">
|
|
16
|
+
<text class="inverse" x="98" y="190">same model</text><text class="inverse" x="264" y="190">same tools</text><text class="inverse" x="416" y="190">same workspace</text><text class="inverse" x="600" y="190">same hidden user facts</text><text class="inverse" x="846" y="190">same budget</text><text class="inverse" x="996" y="190">same reset schedule</text><text class="inverse" x="1240" y="190">≥ 3 repeats</text>
|
|
17
|
+
</g>
|
|
18
|
+
|
|
19
|
+
<!-- parallel lanes -->
|
|
20
|
+
<g>
|
|
21
|
+
<rect x="70" y="258" width="702" height="276" rx="22" fill="#FBFAF6" stroke="#D8D3C8"/>
|
|
22
|
+
<rect x="70" y="258" width="10" height="276" rx="5" fill="#C7C2B8"/>
|
|
23
|
+
<rect x="828" y="258" width="702" height="276" rx="22" fill="#FBFAF6" stroke="#D8D3C8"/>
|
|
24
|
+
<rect x="828" y="258" width="10" height="276" rx="5" fill="#4169E1"/>
|
|
25
|
+
<text class="eyebrow" x="104" y="292" fill="#58636D">A · BASELINE</text><text class="h" x="104" y="320">Normal Agent, no LOOM</text>
|
|
26
|
+
<text class="eyebrow" x="862" y="292" fill="#4169E1">B · TREATMENT</text><text class="h" x="862" y="320">Same Agent, LOOM available</text>
|
|
27
|
+
<g transform="translate(104 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="h" x="14" y="33">Shape the project</text><text class="body" x="14" y="55">questions · decisions</text><text class="body" x="14" y="72">plans · documents</text></g>
|
|
28
|
+
<g transform="translate(332 352)"><rect width="176" height="88" rx="14" fill="#F9E4DE" stroke="#E88773"/><text class="h" x="14" y="33">Force reset</text><text class="body" x="14" y="55">after shaping</text><text class="body" x="14" y="72">and mid-Task</text></g>
|
|
29
|
+
<g transform="translate(560 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#C7C2B8"/><text class="h" x="14" y="33">Fresh Agent</text><text class="body" x="14" y="55">continue from disk</text><text class="body" x="14" y="72">build vertical slice</text></g>
|
|
30
|
+
<path class="edge" d="M280 396H332"/><path class="edge" d="M508 396H560"/>
|
|
31
|
+
<g transform="translate(862 352)"><rect width="176" height="88" rx="14" fill="#FFFFFF" stroke="#4169E1"/><text class="h" x="14" y="33">Shape with LOOM</text><text class="body" x="14" y="55">same brief and Agent</text><text class="body" x="14" y="72">treatment only</text></g>
|
|
32
|
+
<g transform="translate(1090 352)"><rect width="176" height="88" rx="14" fill="#F9E4DE" stroke="#E88773"/><text class="h" x="14" y="33">Force reset</text><text class="body" x="14" y="55">identical timing</text><text class="body" x="14" y="72">identical budget</text></g>
|
|
33
|
+
<g transform="translate(1318 352)"><rect width="176" height="88" rx="14" fill="#E8ECFA" stroke="#4169E1"/><text class="h" x="14" y="33">Fresh Agent</text><text class="body" x="14" y="55">use LOOM disk truth</text><text class="body" x="14" y="72">build vertical slice</text></g>
|
|
34
|
+
<path class="edge" d="M1038 396H1090"/><path class="edge" d="M1266 396H1318"/>
|
|
35
|
+
<text class="small" x="104" y="483">COLLECT</text><text class="body" x="104" y="505">questions · docs · code · tests · time · tokens · user burden · failure recovery</text>
|
|
36
|
+
<text class="small" x="862" y="483">COLLECT</text><text class="body" x="862" y="505">the same artifact classes, under the same stopping rule</text>
|
|
37
|
+
</g>
|
|
38
|
+
|
|
39
|
+
<!-- judging -->
|
|
40
|
+
<g>
|
|
41
|
+
<path class="edge" d="M421 534V580H590"/><path class="edge" d="M1179 534V580H1010"/>
|
|
42
|
+
<rect x="590" y="558" width="420" height="108" rx="20" fill="#FFFFFF" stroke="#E88773" stroke-width="1.5"/>
|
|
43
|
+
<text class="eyebrow" x="800" y="588" text-anchor="middle" fill="#A84D3C">BLIND PAIRWISE JUDGE</text>
|
|
44
|
+
<text class="h" x="800" y="617" text-anchor="middle">Anonymize → randomize → swap order</text>
|
|
45
|
+
<text class="body" x="800" y="642" text-anchor="middle">Preflight the judge packet; broken harness evidence cannot become product evidence.</text>
|
|
46
|
+
</g>
|
|
47
|
+
<g transform="translate(122 708)">
|
|
48
|
+
<rect width="278" height="84" rx="16" fill="#FFFFFF" stroke="#C7C2B8"/>
|
|
49
|
+
<text class="eyebrow" x="16" y="26" fill="#58636D">SCORE NET VALUE</text><text class="body" x="16" y="49">intent · question value · buildability</text><text class="body" x="16" y="67">continuity · burden · cost · ceremony</text>
|
|
50
|
+
</g>
|
|
51
|
+
<g transform="translate(522 698)"><path d="M114 0 228 52 114 104 0 52Z" fill="#FFFFFF" stroke="#4169E1" stroke-width="1.5"/><text class="h" x="114" y="48" text-anchor="middle">Reliable net gain?</text><text class="body" x="114" y="68" text-anchor="middle">across repeats</text></g>
|
|
52
|
+
<g transform="translate(872 708)"><rect width="250" height="84" rx="16" fill="#E3F3ED" stroke="#9AD8C2"/><text class="eyebrow" x="16" y="26" fill="#367D67">YES · ABLATE</text><text class="h" x="16" y="50">Find the causal mechanism</text><text class="body" x="16" y="69">keep only what creates the gain</text></g>
|
|
53
|
+
<g transform="translate(1234 708)"><rect width="250" height="84" rx="16" fill="#F9E4DE" stroke="#E88773"/><text class="eyebrow" x="16" y="26" fill="#A84D3C">NO · BE EVIL</text><text class="h" x="16" y="50">Simplify, revise, or delete</text><text class="body" x="16" y="69">ceremony gets no sympathy</text></g>
|
|
54
|
+
<path class="edge" d="M590 634H261V708"/><path class="edge" d="M400 750H522"/><path class="edge" d="M750 750H872"/><text class="small" x="792" y="738">YES</text><path class="edge" d="M636 802V826H1359V792"/><text class="small" x="664" y="820">NO</text>
|
|
55
|
+
<text class="body" x="70" y="842">A single pilot is directional evidence, not a statistical conclusion. Optional LOOM 1 runs are regression checks—not the primary baseline.</text>
|
|
56
|
+
</svg>
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# LOOM 使用路径审查
|
|
2
|
+
|
|
3
|
+
审查日期:2026-10-18。对象:当前工作区 LOOM 2.1.3 源码。负责人意图:从使用者角度看清完整旅程及副分支,尤其是存量仓库接入、途中改变项目、途中改变 LOOM。此次只审查和制作视图,不修改运行时,不发布包。
|
|
4
|
+
|
|
5
|
+
## 当前判断
|
|
6
|
+
|
|
7
|
+
主交付循环已具备实用的结构保障:初始化、理解记录、设计与能力卷宗、任务依赖、首次 Keeper、执行、逐项证据、阻塞与重开、上下文恢复。现有 28 项端到端测试全部通过。
|
|
8
|
+
|
|
9
|
+
分支的成熟程度并不一致。接入既有仓库后的事实重建、需求变更的影响识别、LOOM 升级后的协议同步、已完成下游任务的失效判断、损坏状态恢复,仍依赖宿主 Agent。CLI 检查的是可检查的结构,不是结果真实成立,也不是业务完成证明。
|
|
10
|
+
|
|
11
|
+
最决定后续优先级的两个问题:①外部变化后,哪些旧理解、审查和完成证据还有效?②下一位 Agent 能否知道自己处在哪条恢复路径,而不是只看到合法文件?主流程继续增加字段,不一定能解决这两点。
|
|
12
|
+
|
|
13
|
+
## 证据边界
|
|
14
|
+
|
|
15
|
+
- 已运行:`npm test`,28 passed;`node tmp/loom-journey-probes.mjs`,12 个隔离行为探针,结果见 `tmp/loom-journey-probe-results.json`。
|
|
16
|
+
- 交互视图包含 38 个情景;浏览器逐一选择并检查路径与详情,也验证了分支按钮;1024/736/360/320px 无横向溢出,无页面脚本错误。记录见 `tmp/loom-journey-view-verification.json`。
|
|
17
|
+
- 已检查:`cli/bin/loom.js`、`cli/src/store.js`、相关 `protocol.js`、`README.zh-CN.md`、`design.md`、当前 `.loom/` 状态。
|
|
18
|
+
- 探针使用独立临时目录和显式 Keeper skip;没有把自审伪装成独立 Keeper。P05 的实测针对 skip 路径,对 passed 路径的结论来自 `startTask` 同一分支的源码检查。
|
|
19
|
+
- 未运行:真实 npm 升级/降级、远端发布、多个 Agent 同时写入、进程断电注入、真实 v1 语义迁移、跨模型长期用户试验。相应结论是源码推断或未验证,不是已复现事故。
|
|
20
|
+
- 源码行号是此次审查时的定位,未来修改可能改变。
|
|
21
|
+
|
|
22
|
+
## 路径全景
|
|
23
|
+
|
|
24
|
+
主干:入口与识别 → 理解与澄清 → 设计/能力/交付面 → 首次独立交接 → 选择与执行任务 → 证据与覆盖 → 完成或继续。恢复、变更和升级可以在任何阶段横切主干。
|
|
25
|
+
|
|
26
|
+
| 分支 | 用户实际遇到的情况 | 现有行为与责任 | 回到哪里 |
|
|
27
|
+
| --- | --- | --- | --- |
|
|
28
|
+
| 新建 | 空仓库开始 | init 生成骨架;Agent 写当前理解,不能把模板当已理解 | 塑形 |
|
|
29
|
+
| 接入 | 已有代码但没有 LOOM | 保留源码与原规则,追加锚点;不自动识别架构、风险或历史决定 | 事实重建后塑形 |
|
|
30
|
+
| 接入 | 仓库已有多套规则/文档 | Agent 识别冲突及权威,不机械覆盖 | 对准真实目标 |
|
|
31
|
+
| 接入 | 子目录/monorepo | context 向上寻找最近 state.json;init 使用当前目录,可能建立另一边界 | 先明确工作区根 |
|
|
32
|
+
| 接入 | 已有 LOOM v2 | init 直接返回 already_initialized;context 恢复 | 当前任务 |
|
|
33
|
+
| 接入 | LOOM v1 或未知 schema | 已知 legacy 目录拒绝覆盖;未知 schema 加载失败;无自动语义迁移 | 备份、显式迁移 |
|
|
34
|
+
| 塑形 | 目标不清/答案改变理解 | Agent 自适应提问,record/decision 更新事实与设计 | 继续澄清 |
|
|
35
|
+
| 塑形 | 用户不可用或要求先做 | 人类通道不可用时记录可逆假设,权威不足则阻塞;不虚构用户确认 | 有界执行或等待 |
|
|
36
|
+
| 能力 | 需要专业判断 | add/research/synthesize/confirm;领域树由 Agent 编写,不是 CLI 自动研究 | 设计与任务 |
|
|
37
|
+
| 能力 | Agent 暂选/研究结论变化 | 暂选有 provisional 状态;重新研究后重建决策树;受影响任务由 Agent 查明 | 更新设计和任务 |
|
|
38
|
+
| 计划 | 大项目/依赖未满足 | Work Map 留盘;上下文聚焦当前任务;依赖完成后才能 start | 可执行任务 |
|
|
39
|
+
| 计划 | 很小的修复 | 初次 ready 仍需真实 PROJECT、设计与非空任务图;任务可有设计/能力豁免,项目级 ready 没有等价轻量入口 | 明确流程代价 |
|
|
40
|
+
| Keeper | 首次通过 | 宿主新开无继承 Agent;摘要、唯一 run_id 和独立声明留痕 | build_ready |
|
|
41
|
+
| Keeper | 需修订/阻塞 | 原文具体 gap 进入下一轮;变更摘要后独立复查,历史未闭合 gap 不能丢 | 塑形与重新交接 |
|
|
42
|
+
| Keeper | 无独立环境 | 显式 skip 留原因;降低证据强度,不称独立通过 | build_ready |
|
|
43
|
+
| Keeper | 审查途中改输入 | 已纳入摘要的文本改变后拒绝旧摘要;STRUCTURE、源码、研究文件等不在摘要内 | 重新准备受影响审查 |
|
|
44
|
+
| 执行 | 正常单任务 | 精确 reads、实现/能力归属、依赖和单 active 检查 | 验证与 done |
|
|
45
|
+
| 执行 | 同一任务中断/换 Agent | context 恢复任务、reads、hooks;Agent 对照 Git、实际文件和 progress | 继续当前任务 |
|
|
46
|
+
| 执行 | API/登录/外部权限缺失 | block 写原因和恢复条件,之后有理由 reopen | 任务选择 |
|
|
47
|
+
| 执行 | 新急事打断当前任务 | 无 pause/suspend/cancel;单 active 限制意味着只能 block 当前任务或改写其范围 | 人工维护任务边界 |
|
|
48
|
+
| 执行 | 多 Agent/多终端 | 一个 active 约束不等于写入锁;无跨命令事务与并发冲突保护 | 单写者或隔离工作区 |
|
|
49
|
+
| 变更 | 颜色/文案/局部 bug | 不改变设计/验收时直接修并验证 | 当前任务 |
|
|
50
|
+
| 变更 | 改目标/验收/边界 | decision → 当前设计 → task update/reopen;CLI 不推断所有影响 | 新任务图 |
|
|
51
|
+
| 变更 | 推翻已完成上游 | 可重开,但已完成下游不自动失效;Agent 需检查依赖闭包 | 重验受影响下游 |
|
|
52
|
+
| 变更 | 人直接编辑文件 | Markdown 当前真相可编辑;无语义差异识别,未写 affected_tasks 不会自动找到旧完成声明 | 对齐后继续 |
|
|
53
|
+
| 变更 | 取消功能/缩小范围 | 没有取消/废弃任务和删除交付单元的正式命令;不应靠假 done 清图 | 显式决定并整理计划 |
|
|
54
|
+
| LOOM 变化 | 工作中升级 CLI 包 | 当前仅校验 schema_version=2,不记录生成协议的包版本;兼容 schema 不保证协议同步 | 备份、版本核对、回归 |
|
|
55
|
+
| LOOM 变化 | 修改本仓库 LOOM 源码 | 已落盘 AGENTS 是旧快照,context 协议取自新代码;全局安装也可能仍旧 | 测源码/安装副本,核对锚点 |
|
|
56
|
+
| LOOM 变化 | 仅修改项目 .loom 文档 | 属于项目决策演化;不要混同 CLI 升级 | 变更流程 |
|
|
57
|
+
| LOOM 变化 | 降级/跨 schema | 不兼容 schema 拒绝;无自动回滚/迁移事务 | 恢复成套代码与状态 |
|
|
58
|
+
| 恢复 | JSON 损坏/初始化半途失败 | 加载报错;只要 state.json 存在,init 不补齐;无 repair/doctor | 备份比对与定点修复 |
|
|
59
|
+
| 恢复 | 丢失 AGENTS 锚点/忘传 sidecar | check 不检查普通锚点;sidecar 每次都需相同参数 | 找回入口与状态位置 |
|
|
60
|
+
| 恢复 | Git 分支/合并/回滚 | 无分支身份或合并语义;依赖 Git 与 Agent 协调代码、文档、状态和证据 | 一致快照后 context |
|
|
61
|
+
| 完成 | 输出缺失 | 新任务 done 检查本地 touches 存在,check 可发现之后删除 | 修复与重新验证 |
|
|
62
|
+
| 完成 | 输出还在但内容错 | 存在检查不是正确性证明;证据文本不由 CLI 实际执行 | 真实验证任务 |
|
|
63
|
+
| 完成 | 所有任务 done 但交付缺项 | complete 由任务状态触发;未覆盖交付只 warning,healthy 仍可 true | 验证交付面 |
|
|
64
|
+
| 完成 | 已 complete 又新增工作 | plan/reopen 将项目恢复为 building;不用每任务重跑 Keeper | 新任务循环 |
|
|
65
|
+
| 完成 | 交付上线/发布受阻 | 文件验收、外部发布、真实使用是不同证据;本仓库发布任务受凭据阻塞 | 外部条件满足后复核 |
|
|
66
|
+
|
|
67
|
+
## 最需要补强的断点
|
|
68
|
+
|
|
69
|
+
### 1. 变化发生后的有效性维护(优先)
|
|
70
|
+
|
|
71
|
+
事实:P06 重开上游,依赖它的已完成下游仍 done,check 无相关提示。`store.js:690` 只改目标任务;`checkProject:1016` 未验证 done 任务的依赖仍 done。`recordDecision:916` 只记录 Agent 给出的 affected_tasks;漏列就没有影响警告。
|
|
72
|
+
|
|
73
|
+
影响:用户一句“我们改成另一种方案”,主链可能更新而旧证明继续看似成立。最小方向:计算依赖影响范围,区分“待复核”与“已失效”,让 Agent 明确处置,不机械把所有下游重做。
|
|
74
|
+
|
|
75
|
+
Keeper 通过后并非永久语义保证。`startTask:718` 不复核摘要;这是“一次交接”的设计边界。需要补的是实质变更后的阶段复核,而不是每任务重跑首次 Keeper。P12 进一步表明 STRUCTURE 的变化不会改变摘要,当前冻结范围应明确展示。
|
|
76
|
+
|
|
77
|
+
### 2. CLI、协议锚点、项目状态的版本关系(优先)
|
|
78
|
+
|
|
79
|
+
事实:P02 重跑 init 保留旧锚点。`initProject:99` 在 state 存在时提前返回;`installAgentAnchor:146` 以 marker 决定是否追加;state 仅有 schema 版本,未绑定 CLI/protocol 版本。`projectDigest:834` 未覆盖 CLI、STRUCTURE、deliverables、源文件或研究文件。
|
|
80
|
+
|
|
81
|
+
影响:升级 LOOM 不等于更新现有项目里的协议;修改源码不等于修改全局安装。最小方向:记录 CLI/schema/protocol 来源;提供可审阅的协议同步与迁移预检,保留原 AGENTS 规则;升级前后在隔离副本跑 context/check 和代表任务。没有执行实际 npm 升级,后果为源码推断。
|
|
82
|
+
|
|
83
|
+
### 3. 恢复建议需要反映可执行现实(其次)
|
|
84
|
+
|
|
85
|
+
事实:P08 活跃任务中调用 ready,project=ready_for_keeper、task=active、keeper 仍 skipped;context 优先建议交接。审查前本仓库也存在 ready_for_keeper + skipped + 无 active + 三 blocked 的组合。`markReady:798` 不限制 active;`compileContext:939` 优先项目状态。
|
|
86
|
+
|
|
87
|
+
最小方向:验证跨状态不变量,按活跃工作、待审查输入、阻塞条件给出一致的下一步;ready 不应无提示遮住执行恢复。
|
|
88
|
+
|
|
89
|
+
### 4. 接入、暂停、取消、损坏恢复(其次)
|
|
90
|
+
|
|
91
|
+
接入是安全脚手架,不是棕地理解器(P01)。有用的接入流程应采样现有架构、测试、未提交修改、既有约束与生产现实,再按本次需求建立最小可信基线。
|
|
92
|
+
|
|
93
|
+
没有 pause/cancel/migrate/repair/upgrade 命令;这是当前能力边界,不是每个项目一定发生的 bug。P03 证实损坏 JSON 时 init 不修复;P09 证实锚点丢失未被 check 识别。`atomicJson:46` 保护单文件替换,不提供多个 JSON 和 Markdown 的事务,也没有并发锁。并发和断电风险尚未注入测试。
|
|
94
|
+
|
|
95
|
+
### 5. 健康、完成、交付要分别呈现(其次)
|
|
96
|
+
|
|
97
|
+
P07 未覆盖交付存在时 project=complete、healthy=true。`completeTask:790` 依据所有任务 done;`checkProject:1080` 对未覆盖只 warning。这可以是合法的结构语义,但用户容易把它听成项目已交付。建议视图和输出分别说明:结构完整性、任务完成度、交付覆盖、真实结果验证。
|
|
98
|
+
|
|
99
|
+
## 当前仓库的真实位置(审查前快照)
|
|
100
|
+
|
|
101
|
+
14 tasks:11 done,3 blocked,无 active;11 个交付单元:11 planned,8 delivered。check healthy=true,带三项尚未交付警告。Keeper=skipped,project=ready_for_keeper。
|
|
102
|
+
|
|
103
|
+
TASK-003 是旧的评估完整性阻塞;TASK-010/TASK-014 是发布凭据类阻塞。后续测试虽然已包含若干修复,也不能凭本次检查擅自宣布这些任务的全部恢复条件成立。本次新增审查任务独立记录,不把历史阻塞当已解决。
|
|
104
|
+
|
|
105
|
+
## 建议的后续顺序
|
|
106
|
+
|
|
107
|
+
先处理变更影响与状态建议一致性,再补 CLI/协议升级与既有仓库接入,最后完善暂停取消和故障恢复。每项都应从具体分支探针倒推验收,不把此次审查直接扩成一轮无边界重写。本轮交付审查结果和路径视图,运行时代码未改。
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
<mxfile host="app.diagrams.net" modified="2026-08-09T22:30:00.000Z" agent="Codex" version="24.7.17">
|
|
2
|
+
<diagram id="loom-production" name="LOOM Production Loops">
|
|
3
|
+
<mxGraphModel dx="1600" dy="1000" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1600" pageHeight="1000" math="0" shadow="0">
|
|
4
|
+
<root><mxCell id="0"/><mxCell id="1" parent="0"/>
|
|
5
|
+
<mxCell id="title" value="One system. Three honest loops." style="text;html=1;fontSize=30;fontStyle=1;fontColor=#17212B;align=left;" vertex="1" parent="1"><mxGeometry x="50" y="30" width="700" height="50" as="geometry"/></mxCell>
|
|
6
|
+
<mxCell id="u-band" value="01 · UNDERSTANDING LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#9AD8C2;fontColor=#367D67;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="110" width="1500" height="240" as="geometry"/></mxCell>
|
|
7
|
+
<mxCell id="u1" value="HUMAN<br><b>Natural request</b><br>idea · correction · answer" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="90" y="205" width="185" height="80" as="geometry"/></mxCell>
|
|
8
|
+
<mxCell id="u2" value="AGENT<br><b>Describe the result</b><br>inspect only when relevant" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="325" y="205" width="215" height="80" as="geometry"/></mxCell>
|
|
9
|
+
<mxCell id="u3" value="Material unknowns still change the whole?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="590" y="195" width="190" height="100" as="geometry"/></mxCell>
|
|
10
|
+
<mxCell id="u4" value="<b>Ask one dense round</b><br>adaptive · consequential<br>not a fixed questionnaire" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="830" y="205" width="205" height="80" as="geometry"/></mxCell>
|
|
11
|
+
<mxCell id="u5" value="<b>Update project truth</b><br>facts · decisions · designs<br>separate field dossiers" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="1085" y="205" width="215" height="80" as="geometry"/></mxCell>
|
|
12
|
+
<mxCell id="u6" value="<b>Build-ready</b><br>candidate" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;fontColor=#17212B;" vertex="1" parent="1"><mxGeometry x="1350" y="205" width="150" height="80" as="geometry"/></mxCell>
|
|
13
|
+
<mxCell id="u-e1" edge="1" source="u1" target="u2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e2" edge="1" source="u2" target="u3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e3" value="yes" edge="1" source="u3" target="u4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/><mxCell id="u-e4" edge="1" source="u4" target="u5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"/>
|
|
14
|
+
<mxCell id="u-no" value="no · local gaps only" edge="1" source="u3" target="u6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;endArrow=block;strokeColor=#17212B;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="685" y="310"/><mxPoint x="1425" y="310"/></Array></mxGeometry></mxCell>
|
|
15
|
+
<mxCell id="u-loop" value="re-evaluate" edge="1" source="u5" target="u3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1190" y="330"/><mxPoint x="685" y="330"/></Array></mxGeometry></mxCell>
|
|
16
|
+
|
|
17
|
+
<mxCell id="k-band" value="02 · KEEPER LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#E88773;fontColor=#A84D3C;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="390" width="1500" height="240" as="geometry"/></mxCell>
|
|
18
|
+
<mxCell id="k1" value="<b>Validate + freeze digest</b><br>PROJECT · designs · dossiers<br>Work Map · first Task" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="90" y="485" width="220" height="80" as="geometry"/></mxCell>
|
|
19
|
+
<mxCell id="k2" value="FRESH AGENT<br><b>Independently inspect</b><br>same frozen digest" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="360" y="485" width="220" height="80" as="geometry"/></mxCell>
|
|
20
|
+
<mxCell id="k3" value="Can responsibly start the first Task?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="630" y="475" width="200" height="100" as="geometry"/></mxCell>
|
|
21
|
+
<mxCell id="k4" value="<b>Return exact gaps</b><br>needs_revision / blocked<br>evidence · files · consequences" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F9E4DE;strokeColor=#E88773;" vertex="1" parent="1"><mxGeometry x="880" y="485" width="220" height="80" as="geometry"/></mxCell>
|
|
22
|
+
<mxCell id="k5" value="<b>Repair the source</b><br>new digest<br>different fresh Keeper" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="1150" y="485" width="180" height="80" as="geometry"/></mxCell>
|
|
23
|
+
<mxCell id="k6" value="<b>Passed</b><br>handoff once" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F3ED;strokeColor=#9AD8C2;" vertex="1" parent="1"><mxGeometry x="1380" y="485" width="130" height="80" as="geometry"/></mxCell>
|
|
24
|
+
<mxCell id="k-e1" edge="1" source="k1" target="k2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e2" edge="1" source="k2" target="k3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e3" value="no" edge="1" source="k3" target="k4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-e4" edge="1" source="k4" target="k5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="k-yes" value="yes" edge="1" source="k3" target="k6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="730" y="450"/><mxPoint x="1445" y="450"/></Array></mxGeometry></mxCell>
|
|
25
|
+
<mxCell id="k-loop" value="new digest · new run_id · new Keeper" edge="1" source="k5" target="k2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1240" y="600"/><mxPoint x="470" y="600"/></Array></mxGeometry></mxCell>
|
|
26
|
+
|
|
27
|
+
<mxCell id="d-band" value="03 · DELIVERY LOOP" style="swimlane;horizontal=1;startSize=52;rounded=1;arcSize=8;fillColor=#FBFAF6;swimlaneFillColor=#FBFAF6;strokeColor=#4169E1;fontColor=#4169E1;fontStyle=1;fontSize=16;" vertex="1" parent="1"><mxGeometry x="50" y="670" width="1500" height="270" as="geometry"/></mxCell>
|
|
28
|
+
<mxCell id="d1" value="<b>Select next Task</b><br>dependencies satisfied<br>active horizon only" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="90" y="770" width="180" height="80" as="geometry"/></mxCell>
|
|
29
|
+
<mxCell id="d2" value="<b>Compile exact context</b><br>reads · constraints<br>done conditions · evidence" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="315" y="770" width="205" height="80" as="geometry"/></mxCell>
|
|
30
|
+
<mxCell id="d3" value="<b>Build → observe</b><br>test → adjust<br>keep local failures local" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#C7C2B8;" vertex="1" parent="1"><mxGeometry x="565" y="770" width="190" height="80" as="geometry"/></mxCell>
|
|
31
|
+
<mxCell id="d4" value="Done conditions actually proven?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="800" y="760" width="180" height="100" as="geometry"/></mxCell>
|
|
32
|
+
<mxCell id="d5" value="<b>Record exact evidence</b><br>complete / block / reopen<br>preserve what comes next" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8ECFA;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1025" y="770" width="205" height="80" as="geometry"/></mxCell>
|
|
33
|
+
<mxCell id="d6" value="More Tasks or new upper gap?" style="rhombus;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#4169E1;" vertex="1" parent="1"><mxGeometry x="1275" y="760" width="170" height="100" as="geometry"/></mxCell>
|
|
34
|
+
<mxCell id="d7" value="DELIVER" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#17212B;strokeColor=#17212B;fontColor=#F5F2EA;fontStyle=1;" vertex="1" parent="1"><mxGeometry x="1470" y="780" width="60" height="60" as="geometry"/></mxCell>
|
|
35
|
+
<mxCell id="d-e1" edge="1" source="d1" target="d2" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e2" edge="1" source="d2" target="d3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e3" edge="1" source="d3" target="d4" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e4" value="yes" edge="1" source="d4" target="d5" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e5" edge="1" source="d5" target="d6" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/><mxCell id="d-e6" value="done" edge="1" source="d6" target="d7" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;endArrow=block;"/>
|
|
36
|
+
<mxCell id="d-local" value="local no · iterate" edge="1" source="d4" target="d3" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="890" y="890"/><mxPoint x="660" y="890"/></Array></mxGeometry></mxCell>
|
|
37
|
+
<mxCell id="d-more" value="more Tasks · or block → repair upper source → reopen" edge="1" source="d6" target="d1" parent="1" style="edgeStyle=orthogonalEdgeStyle;html=1;rounded=1;dashed=1;dashPattern=8 8;endArrow=block;strokeColor=#4169E1;fontColor=#4169E1;"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="1360" y="920"/><mxPoint x="180" y="920"/></Array></mxGeometry></mxCell>
|
|
38
|
+
</root>
|
|
39
|
+
</mxGraphModel>
|
|
40
|
+
</diagram>
|
|
41
|
+
</mxfile>
|