@mc-and-his-agents/loom-installer 0.1.1

package/payload/skills/loom-review/references/shared/harness/workspace-model.md

@@ -0,0 +1,56 @@
+# Workspace Model
+
+本文件定义 Loom 当前最小工作现场模型。
+
+本文件当前承接：
+
+- `EXT-0025`
+- `EXT-0012`
+- `EXT-0037` 的 clean state 部分
+
+## 1. 能力定位
+
+工作现场用于承接正式执行，而不是临时试探。
+
+它负责：
+
+- 为单一正式事项提供隔离现场
+- 为恢复动作提供可定位目标
+- 为该事项消费的 host branch / `git worktree` / PR 绑定提供执行侧锚点
+- 为初始化后的 clean state 提供承载边界
+
+## 2. 最小现场规则
+
+正式执行链路默认使用隔离工作现场，并满足：
+
+- 单现场单事项
+- 同一现场只服务一个主要目标
+- 恢复动作应能回到同一现场
+- 新事项不得默认复用脏现场继续推进
+
+现场标识可以参数化，但必须由稳定输入确定性生成，不能只依赖人工记忆。
+
+## 3. clean state 要求
+
+初始化或现场创建完成后，应处于可继续执行的 clean state。
+
+最小要求：
+
+- 现场与目标事项已明确绑定
+- 进入执行所需的初始工件已经落位
+- 当前现场不存在未分流的无关正式改动
+- 后续恢复不需要重新猜测应进入哪个现场
+
+## 4. 边界约束
+
+Loom 只固化现场隔离、单事项和可恢复定位。
+必要时，Loom 会读取 `active issue` 与 host branch / `git worktree` / PR 的绑定来校验现场是否仍服务同一事项。
+
+Loom 当前不固化：
+
+- 具体目录命名格式
+- 是否必须使用 worktree
+- 具体命令、脚本或平台命名约定
+
+branch、PR 与 git worktree 的宿主边界见 [host-lifecycle-boundary.md](host-lifecycle-boundary.md)。
+`active issue` 绑定消费见 [host-issue-binding.md](host-issue-binding.md)。

package/payload/skills/loom-review/references/shared/templates/pull-request.md

@@ -0,0 +1,44 @@
+# Pull Request
+
+本文件定义 Loom 当前最小 PR 模板规则。
+
+本文件当前承接：
+
+- `EXT-0008`
+- `EXT-0028`
+
+## 1. PR 模板必须服务判断
+
+PR 模板的目标是提供最小必要事实，不是把作者变成填表机器。
+
+## 2. 基础必填块
+
+Loom 的基础 PR 模板至少应包含：
+
+- 本次改动解决什么问题
+- 改动范围是什么
+- 如何验证
+- 有哪些风险或未决项
+- 关联事项是什么
+
+## 3. 条件触发块
+
+PR 模板可以有扩展块，但不应默认强加给所有 PR。
+
+默认要求：
+
+- 只有在当前改动确实涉及对应主题时，才启用额外区块
+- 扩展块应围绕特定风险、迁移、回滚、数据变更等主题展开
+
+## 4. Loom 当前约束
+
+Loom 支持结构化 PR 模板，但必须满足：
+
+- 基础模板保持短小
+- 条件块按需触发
+- 模板内容直接服务 review 与 merge 判断
+
+不允许：
+
+- 用超重模板制造机械性噪音
+- 把长期规则真相写死在 PR 模板里

package/payload/skills/loom-review/references/shared/templates/review-record.md

@@ -0,0 +1,35 @@
+# Review Record
+
+正式 review record 至少应表达：
+
+- `item_id`
+- `kind`
+- `reviewed_head`
+- `reviewed_validation_summary`
+- `decision`
+- `summary`
+- `reviewer`
+- `fallback_to`
+- `findings`
+- `blocking_issues`
+- `follow_ups`
+- `consumed_inputs`
+
+允许结果：
+
+- `allow`
+- `block`
+- `fallback`
+
+约束：
+
+- `fallback_to` 只在 `decision: fallback` 时使用
+- `reviewed_head` 与 `reviewed_validation_summary` 必须对应本次审查基线
+- merge checkpoint 允许 review 之后只新增 Loom 自身的 `review_entry` / recovery / status carriers 提交；除此之外的 `HEAD` 漂移仍视为 stale
+- `findings` 是权威 findings / rebuttal / disposition 数组；每条至少包含 `id`、`summary`、`severity`、`rebuttal`、`disposition`
+- `severity` 当前稳定值为 `warn`、`block`
+- `rebuttal` 当前稳定值为 `null` 或非空字符串
+- `disposition` 当前稳定值为 `null` 或对象；对象内的 `status` 只允许 `accepted`、`rejected`、`deferred`
+- `blocking_issues` / `follow_ups` 仅作为兼容字段保留，默认从 `findings` 投影，不应被当作独立 authored 真相
+- `consumed_inputs.engine_adapter`、`consumed_inputs.engine_evidence`、`consumed_inputs.normalized_findings` 只记录 evidence 来源，不构成第二 authored truth
+- review record 是 merge checkpoint 的正式输入之一，不得只留在会话或 PR 评论里

package/payload/skills/loom-review/references/shared/templates/spec-suite.md

@@ -0,0 +1,57 @@
+# Spec Suite
+
+本文件定义 Loom 当前最小正式规约套件。
+
+本文件当前承接：
+
+- `EXT-0015`
+- `EXT-0016`
+- `EXT-0017`
+
+## 1. 正式规约套件的最小边界
+
+Loom 当前把正式规约套件的最小内核定义为：
+
+- `spec.md`
+- `plan.md`
+
+这两个工件分别承担不同职责，不得混写。
+
+## 2. `spec.md` 最小要求
+
+`spec.md` 至少应表达：
+
+- 目标
+- 范围
+- 关键场景，优先使用 `GWT`
+- 异常与边界
+- 验收标准
+
+## 3. `plan.md` 最小要求
+
+`plan.md` 至少应表达：
+
+- 实施目标
+- 阶段拆分
+- 约束
+- 验证方式
+- `TDD` 或测试策略
+- 依赖关系
+- 进入实现前条件
+
+## 4. 套件边界规则
+
+Loom 必须区分：
+
+- 正式契约工件
+- 执行或进度工件
+
+默认要求：
+
+- `spec.md` 与 `plan.md` 属于正式最小套件
+- 进度跟踪类工件是否存在，可以按项目需要扩展
+
+Loom 当前不固化：
+
+- 所有项目都必须有同一组附加工件
+- `TODO.md` 或同类文件是永恒必选项

package/payload/skills/loom-review/scripts/loom-review.py

@@ -0,0 +1,16 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import os
+import runpy
+import sys
+from pathlib import Path
+
+SCRIPT_PATH = Path(__file__).resolve()
+PACKAGE_ROOT = SCRIPT_PATH.parents[1]
+RUNTIME_ROOT = PACKAGE_ROOT / ".loom-runtime"
+
+os.environ.setdefault("LOOM_INSTALLED_SKILLS_ROOT", str(RUNTIME_ROOT))
+os.environ.setdefault("LOOM_PACKAGE_SKILL_ID", "loom-review")
+sys.path.insert(0, str(RUNTIME_ROOT / "shared/scripts"))
+runpy.run_path(RUNTIME_ROOT / "shared/scripts/loom_flow.py", run_name="__main__")