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

package/payload/plugin/loom/skills/loom-adopt/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: loom-adopt
+description: 负责把仓库接入 Loom 的初始化场景入口。Use when Codex needs to initialize a new repository with Loom or retrofit Loom into an existing repository.
+---
+
+# Loom Adopt
+
+这个 skill 承接初始化与 retrofit 场景。
+
+它只编排已有 root bootstrap 能力，不新增并行事实源，不创建第二套日常执行入口。
+
+## 1. 使用时机
+
+当任务满足以下任一条件时，进入 `loom-adopt`：
+
+- 明确要求初始化新项目
+- 明确要求把既有仓库接入 Loom
+- 明确要求 retrofit Loom 入口、首批工件或初始化事实链
+- 当前任务核心问题是“如何进入 Loom”，而不是“如何恢复、review、handoff、retire 或 merge-ready”
+
+若任务其实是接手当前事项、review 前检查、交接、retire 或 merge-ready，应回到 root route matrix，转向对应场景 skill：
+
+- [../route-matrix.md](../route-matrix.md)
+
+## 2. 读取顺序
+
+按以下顺序读取：
+
+- 目标仓库中的 `AGENTS.md`、`README`、流程文档、模板、验证入口
+- Loom 根级定位文档
+  - `AGENTS.md`
+  - `README.md`
+- 初始化相关稳定规则
+  - [../shared/references/adoption/lightweight-retrofit-default.md](../shared/references/adoption/lightweight-retrofit-default.md)
+  - [../shared/references/adoption/routing-and-checkpoints.md](../shared/references/adoption/routing-and-checkpoints.md)
+  - [../shared/references/harness/fact-chain-contract.md](../shared/references/harness/fact-chain-contract.md)
+  - [../loom-init/references/input-signals.md](../loom-init/references/input-signals.md)
+  - [../loom-init/references/output-contract.md](../loom-init/references/output-contract.md)
+- 本 skill 的场景合同
+  - [references/input-signals.md](./references/input-signals.md)
+  - [references/output-contract.md](./references/output-contract.md)
+
+## 3. 固定编排
+
+本 skill 不新增新 CLI，固定复用：
+
+- `python3 scripts/loom-adopt.py bootstrap --target <repo>`
+- `python3 scripts/loom-adopt.py verify --target <repo>`
+- `python3 scripts/loom-adopt.py fact-chain --target <repo>`
+
+执行顺序固定为：
+
+1. 先判断这是 `新项目`、`小型既有仓库` 还是 `复杂既有仓库`
+2. 再给出本轮启用能力、暂不启用能力与升级触发条件
+3. 若用户要求实际落盘，再执行 `bootstrap --write`
+4. 落盘后必须能用 `verify` 与 `fact-chain` 复读
+
+## 4. 输出要求
+
+输出必须直接遵守初始化输出合同，而不是另写一套 adopt 专属真相：
+
+- [../loom-init/references/output-contract.md](../loom-init/references/output-contract.md)
+
+至少要明确：
+
+- 当前初始化场景判断
+- 本轮启用能力
+- 首批工件与首批事项
+- 事实链入口
+- 验证入口
+- 当前不启用什么，以及为什么
+
+## 5. 完成标准
+
+只有当以下条件同时满足时，才算 `loom-adopt` 完成：
+
+- root route 或显式 skill 调用都能稳定命中 `loom-adopt`
+- `bootstrap` 输出能解释为什么是这条 adoption 路径
+- `verify` 与 `fact-chain` 都能消费落盘结果
+- 结果没有引入新的事实链载体或平行状态源

package/payload/plugin/loom/skills/loom-adopt/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Loom Adopt"
+  short_description: "初始化或 retrofit 仓库到 Loom"
+  default_prompt: "判断当前仓库的初始化场景，并复用 loom_init bootstrap/verify/fact-chain 给出首批 Loom 接入结果。"

package/payload/plugin/loom/skills/loom-adopt/contract.json

@@ -0,0 +1,45 @@
+{
+  "id": "loom-adopt",
+  "role": "scenario/adopt",
+  "contract_version": "1.4.0",
+  "display_name": "Loom Adopt",
+  "description": "Route initialization and retrofit work to the existing Loom bootstrap, verify, and fact-chain entry points.",
+  "root_entry": false,
+  "entrypoint": {
+    "skill_markdown": "SKILL.md",
+    "adapter_metadata": "agents/openai.yaml",
+    "orchestration_cli": "scripts/loom-adopt.py"
+  },
+  "input_contract": {
+    "reference": "references/input-signals.md",
+    "required_fields": [
+      "task_is_initialization_or_retrofit",
+      "target_repository",
+      "adoption_scope",
+      "write_intent"
+    ]
+  },
+  "output_contract": {
+    "reference": "references/output-contract.md",
+    "required_sections": [
+      "scenario_judgment",
+      "enabled_capabilities",
+      "deferred_capabilities",
+      "first_artifacts",
+      "first_work_items",
+      "runtime_state",
+      "governance_surface",
+      "fact_chain",
+      "validation_entry"
+    ]
+  },
+  "routing": {
+    "reference": "../route-matrix.md",
+    "explicit_name": "loom-adopt"
+  },
+  "installation": {
+    "registry": "../registry.json",
+    "upgrade_contract": "../upgrade-contract.json",
+    "layout_manifest": "../install-layout.json"
+  }
+}

package/payload/plugin/loom/skills/loom-adopt/references/input-signals.md

@@ -0,0 +1,17 @@
+# Loom Adopt Input Signals
+
+当任务满足以下任一信号时，进入 `loom-adopt`：
+
+- 明确要求初始化新项目
+- 明确要求把既有仓库接入 Loom
+- 明确要求 retrofit Loom 入口、首批工件或初始化事实链
+- 明确要求判断某个仓库应该采用哪条 Loom 初始化路径
+
+最小输入：
+
+- 目标仓库
+- 当前接入范围
+- 是否需要实际落盘
+- 当前任务是否仍属于初始化，而不是恢复/交接/review/merge-ready
+
+若缺少最后一项，必须先回到 [../../route-matrix.md](../../route-matrix.md) 重新判断场景。

package/payload/plugin/loom/skills/loom-adopt/references/output-contract.md

@@ -0,0 +1,17 @@
+# Loom Adopt Output Contract
+
+`loom-adopt` 不定义新的输出真相。
+
+它必须直接复用：
+
+- [../../loom-init/references/output-contract.md](../../loom-init/references/output-contract.md)
+
+对场景入口本身，最少还要让执行者能直接读出：
+
+- 当前初始化场景判断
+- 本轮启用能力
+- 当前暂不启用能力与升级触发条件
+- 首批工件与首批事项
+- 事实链入口
+- 验证入口
+- 是否已经实际落盘

package/payload/plugin/loom/skills/loom-adopt/scripts/loom-adopt.py

@@ -0,0 +1,14 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import os
+import runpy
+import sys
+from pathlib import Path
+
+SCRIPT_PATH = Path(__file__).resolve()
+SKILLS_ROOT = SCRIPT_PATH.parents[2]
+
+os.environ.setdefault("LOOM_INSTALLED_SKILLS_ROOT", str(SKILLS_ROOT))
+sys.path.insert(0, str(SKILLS_ROOT / "shared/scripts"))
+runpy.run_path(SKILLS_ROOT / "shared/scripts/loom_init.py", run_name="__main__")

package/payload/plugin/loom/skills/loom-handoff/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: loom-handoff
+description: 负责交接当前事项。Use when Codex needs to prepare a handoff package before ending the current execution round.
+---
+
+# Loom Handoff
+
+这个 skill 承接 handoff 场景。
+
+优先入口：
+
+- `python3 scripts/loom-handoff.py flow handoff --target <repo> [--item <id>]`
+
+执行要求：
+
+- 只读取现有事实链、状态检查和现场定位结果
+- 只输出 handoff 所需的最小回写清单与载体定位
+- 不直接写 recovery entry、status surface 或其他 authored 载体
+
+输入信号与输出合同见：
+
+- [references/input-signals.md](./references/input-signals.md)
+- [references/output-contract.md](./references/output-contract.md)

package/payload/plugin/loom/skills/loom-handoff/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Loom Handoff"
+  short_description: "生成交接前最小回写清单"
+  default_prompt: "读取当前 Loom 事项状态，只输出 handoff 所需的最小回写清单和定位信息，不直接回写任何 authored 载体。"

package/payload/plugin/loom/skills/loom-handoff/contract.json

@@ -0,0 +1,53 @@
+{
+  "id": "loom-handoff",
+  "role": "scenario/handoff",
+  "contract_version": "1.3.0",
+  "display_name": "Loom Handoff",
+  "description": "Produce the minimum handoff writeback checklist and locator set without creating a second authored truth source.",
+  "root_entry": false,
+  "entrypoint": {
+    "skill_markdown": "SKILL.md",
+    "adapter_metadata": "agents/openai.yaml",
+    "orchestration_cli": "scripts/loom-handoff.py"
+  },
+  "input_contract": {
+    "reference": "references/input-signals.md",
+    "required_fields": [
+      "target_repository",
+      "current_item_or_active_item",
+      "handoff_intent"
+    ]
+  },
+  "output_contract": {
+    "reference": "references/output-contract.md",
+    "required_sections": [
+      "item",
+      "result",
+      "summary",
+      "missing_inputs",
+      "fallback_to",
+      "runtime_state",
+      "workspace",
+      "checkpoint",
+      "state_check",
+      "steps",
+      "recovery_entry",
+      "status_surface",
+      "current_stop",
+      "next_step",
+      "blockers",
+      "latest_validation_summary",
+      "fallback_target",
+      "writeback_fields"
+    ]
+  },
+  "routing": {
+    "reference": "../route-matrix.md",
+    "explicit_name": "loom-handoff"
+  },
+  "installation": {
+    "registry": "../registry.json",
+    "upgrade_contract": "../upgrade-contract.json",
+    "layout_manifest": "../install-layout.json"
+  }
+}

package/payload/plugin/loom/skills/loom-handoff/references/input-signals.md

@@ -0,0 +1,7 @@
+# Loom Handoff Input Signals
+
+当任务满足以下任一信号时，进入 `loom-handoff`：
+
+- 交接当前事项
+- 回写停点
+- 移交给下一个执行者

package/payload/plugin/loom/skills/loom-handoff/references/output-contract.md

@@ -0,0 +1,42 @@
+# Loom Handoff Output Contract
+
+输出固定为 handoff 摘要 JSON，至少需要给出：
+
+- `item`
+  - 当前事项编号、目标、范围、执行路径
+- `result`
+  - `pass` 或 `block`
+- `summary`
+  - 对当前 handoff 可移交状态的单句结论
+- `missing_inputs`
+  - 当前仍需补齐的阻断项；无阻断时为空数组
+- `fallback_to`
+  - 若当前状态不适合直接移交，应回退到哪个 checkpoint；无回退时为 `null`
+- `runtime_state`
+  - 当前 Loom 入口自己的 scene / carrier 判定，以及 fail-closed 原因
+- `workspace`
+  - `workspace_entry`、解析后的现场路径、现场是否存在
+- `checkpoint`
+  - 原始 checkpoint 文本与归一化后的 checkpoint
+- `state_check`
+  - `state-check` 的结果、摘要、阻断项与检查分项
+- `recovery_entry`
+  - 当前 recovery entry 的定位字符串
+- `status_surface`
+  - 当前 status surface 的定位字符串
+- `current_stop`
+  - 当前执行停点，供交接前回写
+- `next_step`
+  - 下一个执行动作，供交接前回写
+- `blockers`
+  - 当前阻断项，供交接前回写
+- `latest_validation_summary`
+  - 最近验证摘要，供交接前回写
+- `fallback_target`
+  - 若当前未准备好移交，应优先回退到的目标；无回退时为 `null`
+- `writeback_fields`
+  - 固定为 `current_stop`、`next_step`、`blockers`、`latest_validation_summary`
+- `steps`
+  - 固定按 `runtime-state -> fact-chain -> state-check -> workspace-locate` 顺序列出
+
+这个 skill 只生成回写清单和定位，不直接写文件，也不创建新的 authored 真相源。

package/payload/plugin/loom/skills/loom-handoff/scripts/loom-handoff.py

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

package/payload/plugin/loom/skills/loom-init/SKILL.md

@@ -0,0 +1,246 @@
+---
+name: loom-init
+description: Loom 的 root entry。负责初始化新项目或既有仓库，并在非初始化任务下根据任务信号把执行者路由到正确场景 skill。Use when Codex needs to start a repository on top of Loom, retrofit Loom into an existing repo, or route a Loom operator to the right scenario skill.
+---
+
+# Loom Init
+
+把本 skill 作为 Loom 的默认入口。
+
+在以下情况先进入 `loom-init`：
+
+- 你要初始化 Loom，或把 Loom retrofit 进既有仓库
+- 你还不知道当前任务应该进入哪个场景 skill
+- 你希望 Loom 先根据任务信号判断下一步入口
+
+不要把 root skill 继续扩成第二套事实真相源。它负责先判断，再导向正确场景。
+
+对执行者的首层说明仍应以 `loom-init` 作为 root entry。repo-local 自动化、验证、调试和宿主编排可以统一落到 repo-local `loom CLI`，但这不改变 `loom-init` 的 route 语义，也不把 CLI 升格成用户第一入口。
+
+## Quick Path
+
+1. 先判断当前任务属于初始化 / retrofit，还是已经进入日常执行场景。
+2. 如果用户已经显式指定场景 skill，显式调用优先，直接进入该 skill。
+3. 如果没有显式指定 skill，由 `loom-init` 根据任务信号做路由。
+4. 如果信号不足、冲突，或缺少稳定执行所需的最小输入，保留在 `loom-init`，并要求最小补充信号。
+
+## Route Summary
+
+显式指定 skill 时，显式调用优先。
+
+未显式指定 skill 时，`loom-init` 按任务信号做隐式路由。
+
+默认场景对应关系如下：
+
+- 初始化 / retrofit / 新项目接入
+  - 路由到 `loom-adopt`
+- 接手事项 / 恢复上下文 / 继续推进
+  - 路由到 `loom-resume`
+- review 前检查 / 进入 review 前预检
+  - 路由到 `loom-pre-review`
+- 正式 review / 语义审查 / review 结论
+  - 路由到 `loom-review`
+- 交接 / 回写停点 / 移交当前事项
+  - 路由到 `loom-handoff`
+- 清理现场 / retire 当前事项
+  - 路由到 `loom-retire`
+- merge-ready / 最终放行前预检
+  - 路由到 `loom-merge-ready`
+
+如果信号不足或同时命中多个场景，不要猜测。回退到 `loom-init`，并要求最小补充信号。
+
+完整场景路由规则见 [../route-matrix.md](../route-matrix.md)。
+
+## Installed Entry Surface
+
+当前安装态中的最小可执行入口为：
+
+- `loom init bootstrap --target <repo>`
+- `loom init verify --target <repo>`
+- `loom init fact-chain --target <repo>`
+- `loom route --target <repo> [--skill <id>] [--task "<request>"]`
+
+安装态或 repo-local 开发态可以把这些 `loom ...` 动作映射到底层 `scripts/...` 或 `tools/...` carrier；首层用户入口仍然是 `loom-init` 这个 skill。
+
+## 1. 读取顺序
+
+按以下顺序读取材料：
+
+- 目标仓库中的 `AGENTS.md`、`README`、流程文档、PR 模板、issue 模板
+- Loom 根文档：
+  - `AGENTS.md`
+  - `README.md`
+- Loom 核心规则：
+  - `skills/shared/references/governance/principles.md`
+  - `skills/shared/references/governance/review-model.md`
+  - `skills/shared/references/governance/maturity-and-closing.md`
+  - `skills/shared/references/adoption/routing-and-checkpoints.md`
+  - `skills/shared/references/adoption/lightweight-retrofit-default.md`
+  - `skills/shared/references/adoption/deep-existing-repo-default.md`
+- `skills/shared/references/harness/recovery-model.md`
+- `skills/shared/references/harness/fact-chain-contract.md`
+- `skills/shared/references/harness/status-surface.md`
+- `skills/shared/references/harness/work-item-contract.md`
+- `skills/shared/references/harness/workspace-model.md`
+- `skills/route-matrix.md`
+- `skills/loom-init/references/input-signals.md`
+- `skills/shared/references/harness/automation-frontload.md`
+- `skills/shared/references/harness/workspace-and-purity.md`
+- `skills/shared/references/harness/execution-context.md`
+- `skills/shared/references/templates/spec-suite.md`
+- `skills/shared/references/templates/pull-request.md`
+- `skills/loom-init/references/output-contract.md`
+
+只有在事项带有明显不确定性、需要进一步分层时，才补读：
+
+- 由宿主额外提供的候选 adoption 材料；不要假设安装态自带候选层全文
+
+## 2. 建立初始化问诊
+
+优先从仓库现状推断答案，只在关键信息缺失时再问用户。
+
+使用 [references/input-signals.md](./references/input-signals.md) 组织问诊。必须先完成最小必判字段的收集，再做路径判断。
+
+问诊结果必须收成以下结论，而不是停留在零散观察：
+
+- 初始化场景
+  - `新项目`
+  - `小型既有仓库`
+  - `复杂既有仓库`
+- 装配强度
+  - `轻量`
+  - `标准`
+  - `强化`
+- 默认接入方式
+  - 根级重写
+  - `companion docs`
+- 恢复形态
+  - `checkpoint-lite`
+  - 标准恢复形态
+- 首批执行入口与验证入口
+- 初始 clean state 目标
+
+## 3. 做出装配判断
+
+不要输出抽象“建议采用 Loom”。必须把判断落成“判定信号 -> 默认动作”的装配决策。
+
+### 3.1 新项目
+
+当仓库尚未形成稳定工程基线、目标是建立最小起步结构时，判为 `新项目`。
+
+默认动作：
+
+- 采用最小装配
+- 不预装重 harness
+- 只建立后续可升级入口
+- 只引入当前能支撑持续演进的最小治理、模板与验证入口
+- 恢复形态默认从轻量开始；若当前没有跨多轮承接需求，可以只声明升级条件，不提前铺满恢复工件
+
+### 3.2 小型既有仓库
+
+当仓库满足 [../shared/references/adoption/lightweight-retrofit-default.md](../shared/references/adoption/lightweight-retrofit-default.md) 的默认条件时，判为 `小型既有仓库`。
+
+默认动作：
+
+- 直接消费 `lightweight retrofit default`
+- 默认采用 `companion docs` 接入
+- 默认装配：
+  - `WORKFLOW`
+  - `code_review`
+  - `spec_review`
+  - 最小 PR 模板
+  - 条件化 `spec.md` / `plan.md`
+- 默认不装配：
+  - 完整 recovery 模型
+  - work item 合同
+  - 状态面
+  - profile 分层
+  - 重 harness
+- 若需要轻量跨轮承接，默认使用 `checkpoint-lite`
+- 即使本轮不装配标准恢复或状态面，也必须写清：
+  - issue / PR 中谁是恢复主入口
+  - 哪个载体承接当前停点、下一步、阻断项与最近验证摘要
+- 只要缺少统一验证入口，或仓库主产物本身是共享 contract、shared skill 或 governance module，就不得继续套用这条轻量路径
+
+### 3.3 复杂既有仓库
+
+既有仓库只要不满足轻量条件，或已经出现明显恢复痛点、共享边界风险、现场混杂、review 过载、统一验证入口缺失中的任一高强度信号，就判为 `复杂既有仓库`。
+
+默认动作：
+
+- 若根规则清晰、验证入口稳定且命中 `merge_review_semantic_overload`，优先进入 `deep-existing-repo` / `recognize-and-attach`
+- 否则进入更完整装配
+- 显式纳入：
+  - 恢复主入口
+  - 执行上下文
+  - work item 或等价执行入口
+  - 状态读取
+  - 隔离现场与纯度规则
+- 对涉及共享契约、运行模型、高风险核心抽象的事项，默认纳入正式规约套件与前移 checkpoint
+- 对恢复成本明显升高的事项，默认从 `checkpoint-lite` 升级到标准恢复形态
+
+当命中 `deep-existing-repo` 时，额外保持以下纪律：
+
+- 保留 root rules
+- 保留 retained host actions
+- 保留 repo-native carriers
+- 第一轮不生成 Loom-owned `work-item` / `progress` / `status-surface` placeholder
+
+## 4. 输出初始化结果
+
+始终使用 [references/output-contract.md](./references/output-contract.md) 的结构输出结果。
+
+输出中必须显式写出：
+
+- 初始化场景
+- 装配强度
+- 恢复形态
+- 首批执行入口
+- 验证入口
+- 事实链 carrier 定位
+- 初始 clean state
+- 本轮暂不装配能力的承接方式
+
+如果用户要求实际初始化仓库，按以下顺序执行：
+
+1. 建立根级规则入口或 `companion docs` 入口
+2. 建立治理与 adoption 最小工件
+3. 建立 harness 与模板最小工件
+4. 建立首批 issue / checkpoint / 验证路径
+5. 核对输出是否已经形成可继续执行的初始化产物模型
+
+## 5. 处理三类场景的差异
+
+### 5.1 新项目
+
+- 直接给出最小装配方案
+- 优先保证后续能持续演进
+- 避免把未来可能需要的能力提前全部引入
+- 不默认铺满重 harness，只写清升级入口与触发条件
+
+### 5.2 小型既有仓库
+
+- 默认走 `lightweight retrofit default`
+- 仅当仓库真正满足轻量路径前提时，才沿用该默认策略
+- 先指出当前结构性问题
+- 再给出渐进 adoption 顺序
+- 明确哪些问题先通过规则解决，哪些问题后续再脚本化
+- 不要把 recovery、work-item、status-surface 当成第一轮默认必装项
+- 若走 `checkpoint-lite`，必须写清 issue / PR 对停点、下一步、阻断项、验证摘要的承接方式
+
+### 5.3 复杂既有仓库
+
+- 先指出导致不能走轻量路径的升级信号
+- 再给出更完整装配顺序
+- 必须写清正式执行入口、恢复主入口、状态读取入口与现场绑定方式
+- 若涉及共享边界或高风险实现承诺，必须写清正式规约工件与 checkpoint 承接关系
+
+## 6. 验证标准
+
+只有当以下条件同时满足时，才把初始化视为完成：
+
+- 输出结果能解释为什么是这组能力，而不是另外两条路径
+- 输出结果能映射回 Loom 当前文档中的明确规则
+- 首批工件、首批事项、恢复形态、验证入口与初始 clean state 可以直接承接后续执行
+- 明确保留了“现在不做什么”，且写清升级触发条件
+- 对未装配能力给出了明确承接方式，而不是留给临场经验补齐

package/payload/plugin/loom/skills/loom-init/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Loom Init"
+  short_description: "作为 Loom root entry，负责初始化或路由到正确场景 skill"
+  default_prompt: "如果任务是初始化或 retrofit，就输出 Loom 接入方案；如果任务是日常执行场景，就根据任务信号把执行者路由到正确场景 skill。"

package/payload/plugin/loom/skills/loom-init/contract.json

@@ -0,0 +1,76 @@
+{
+  "id": "loom-init",
+  "role": "bootstrap/root",
+  "contract_version": "1.3.0",
+  "display_name": "Loom Init",
+  "description": "Bootstrap Loom into a target repository and route operators to the right scenario skill when the task is not a fresh initialization request.",
+  "root_entry": true,
+  "entrypoint": {
+    "skill_markdown": "SKILL.md",
+    "adapter_metadata": "agents/openai.yaml",
+    "bootstrap_cli": "scripts/loom-init.py",
+    "route_cli": "scripts/loom-init.py"
+  },
+  "input_contract": {
+    "reference": "references/input-signals.md",
+    "required_fields": [
+      "repository_type",
+      "root_boundary_docs",
+      "ci_or_basic_tests",
+      "repository_level_validation_entry",
+      "primary_gap_category",
+      "long_running_recovery_pain",
+      "shared_contract_or_high_risk_boundary",
+      "purity_or_scope_signals",
+      "merge_review_semantic_overload"
+    ]
+  },
+  "output_contract": {
+    "reference": "references/output-contract.md",
+    "required_sections": [
+      "project_judgment",
+      "recommended_adoption",
+      "deferred_capabilities",
+      "fact_chain",
+      "initial_artifacts",
+      "initial_work_items",
+      "runtime_state",
+      "validation_and_closing"
+    ]
+  },
+  "routing": {
+    "reference": "../route-matrix.md",
+    "priority_order": [
+      "explicit skill name",
+      "task signal routing",
+      "fallback to loom-init with missing inputs"
+    ],
+    "fallback_entry": "loom-init"
+  },
+  "artifact_mapping": {
+    "rules": [
+      "../shared/references/governance",
+      "../shared/references/harness",
+      "../shared/references/templates",
+      "../shared/references/adoption"
+    ],
+    "skill_refs": [
+      "references/input-signals.md",
+      "references/intake-signals.md",
+      "references/output-contract.md"
+    ],
+    "default_targets": [
+      ".loom/bootstrap/init-result.json",
+      ".loom/work-items/INIT-0001.md",
+      ".loom/progress/INIT-0001.md",
+      ".loom/status/current.md",
+      ".loom/specs/INIT-0001/spec.md",
+      ".loom/specs/INIT-0001/plan.md"
+    ]
+  },
+  "installation": {
+    "registry": "../registry.json",
+    "upgrade_contract": "../upgrade-contract.json",
+    "layout_manifest": "../install-layout.json"
+  }
+}

package/payload/plugin/loom/skills/loom-init/references/input-signals.md

@@ -0,0 +1,16 @@
+# Loom Init Input Signals
+
+`loom-init` 继续使用现有初始化问诊信号作为 root 入参合同。
+
+稳定输入信号见：
+
+- [intake-signals.md](./intake-signals.md)
+
+当任务不是初始化，而是执行中的日常动作时，还必须结合：
+
+- [../../route-matrix.md](../../route-matrix.md)
+
+root skill 只在两种情况下继续留在 `loom-init`：
+
+- 任务明确是初始化 / retrofit
+- 任务信号不足，无法稳定路由到单一场景 skill