用途
landscape-discovery-audit 是“五阶段结构整改协议”（pentaphase structural-overhaul protocol）的第 1 阶段。它的职责是在进行任何结构性改造之前，先对目标系统做一次描述性的现状发现与基线审计，产出一份可供下一阶段（taxonomy-modeling-design）消费的 landscape 报告。
该技能在项目工作目录中读取 substrate-context.md，该文件说明正在审计的对象（WHAT）以及审计的原因（WHY）。如果该文件缺失，技能会停止，并请用户先运行 pentaphase-orchestrator 的 Phase 0，或者让用户口述 substrate、驱动力、主要失败点、运营角色和时间范围，以便技能自行写入 substrate-context.md。技能要求在开始任何工作流之前完整阅读 substrate-context.md。
四条工作流与产出
技能由四条工作流组成，每条各自产出一个命名的输出，最后合并为最终报告。四条工作流可以按任意顺序执行，但每条都需要先在工作目录中形成独立章节，再组装报告。
Stream 1 — 盘点资产（Inventory Assets）
记录 substrate 中每一个现有的核心产出、组件和数据点。每个资产需记录以下字段：
- Name（必填）：系统内的规范名称，以及任何别名
- Location（必填）：绝对路径、URL、注册表 id 或坐标
- Owner（必填）：负责的人、团队或角色
- State（必填）：active / archived / deprecated / orphaned / unknown
- Last touched（必填）：可发现时填写 ISO 日期，否则填 "unknown"
- Size / scale（必填）：行数、文件数、字节数或领域原生单位
- Dependencies（可选）：该资产依赖的其他资产
- Notes（可选）：任何值得标记的异常
输出格式为 markdown 表格或分节列表。要求下沉到叶子层级，而不是分支层级——“the docs folder” 是一个分支，其中的单个文件才是叶子。如果 substrate 太大，无法一次穷尽枚举，可按类别抽样，并明确声明抽样方法。
Stream 2 — 映射现有流程（Map Current Flow）
追踪条目从创建到最终归档的路径。对每一条不同的流程，记录：
- Trigger：什么触发该流程（事件、计划、人工操作）
- Stages：条目经过的有序状态列表
- Actors：谁或什么推进每个阶段（人工角色、自动化、混合）
- Handoffs：状态在参与者之间转移的位置（这些是容易产生摩擦的点）
- Termination：流程如何结束（归档、删除、升级、放弃）
- Volume：单位时间内的条目数（若流程不规则，则为积压深度）
如果存在多条不同流程，分别记录，逐一编号。可使用叙述、ASCII 图或序列列表，以最清晰者为准。
Stream 3 — 识别摩擦（Identify Friction）
定位结构性瓶颈、沟通缺口和系统性低效。对每个摩擦点记录：
- Friction point：具体、有名称、在流程中有位置
- Type：bottleneck / gap / inefficiency / drift / silo / coordination cost / quality leak
- Frequency：多久发生一次（每次事件、每周、每月、偶发）
- Impact：在时间、金钱、质量、士气、机会上的代价
- Root cause hypothesis：对其底层机制的最佳判断
要求避免泛泛的抱怨。"慢流程" 不是摩擦点。"工单在 'awaiting-review' 状态平均停留 6 天，因为审核人没有被呼叫" 才是摩擦点。
Stream 4 — 定义价值指标（Define Value Metrics）
为速度、准确性和利用率建立清晰的成功指标。每个维度至少一个指标。每个指标记录：
- Name
- Definition：测量什么、如何测量、用什么工具
- Current baseline：当前值，含测量方法和日期
- Target：整改后需要达到的位置
- Cadence：多久测量一次
- Threshold：触发告警或升级的值（可选但推荐）
指标必须可测量。"更好的 UX" 不是指标。"工单创建到首次响应的时间，p50，以分钟计" 才是指标。
报告组装
四条工作流合并为工作目录下的单一文件 phase-1-landscape-report.md，结构如下：
# Phase 1 — Landscape Report
**Substrate:** <name from substrate-context.md>
**Date:** YYYY-MM-DD
**Preconditions:** Read substrate-context.md (path)
**Postconditions:** Ready for Phase 2 (taxonomy-modeling-design)
## 1. Executive summary
3–5 sentences on the substrate's current shape and biggest pain.
## 2. Assets inventory
[full table or sectioned list]
## 3. Current flow map
[per-flow sections]
## 4. Friction register
[per-friction-point list]
## 5. Value metrics
[per-metric definitions with baselines]
## 6. Open questions for Phase 2
[explicit list of gaps, ambiguities, or decisions deferred to taxonomy design]
门禁标准
审计者会检查以下条件，报告通过 Phase 1 门禁当且仅当：
- 资产覆盖率 ≥ 80%——没有主要资产类别缺失。如果使用了抽样，需声明抽样方法。
- 至少一条流程被端到端映射——从触发到终止，包含阶段、参与者和交接。
- 摩擦登记表至少有 3 个具名摩擦点——每个都带有类型、频率、影响和根因假设。
- 价值指标覆盖速度 AND 准确性两个维度——每个都有当前基线和目标。利用率鼓励但不强制。
- 存在 Phase 2 开放问题章节——即使为空也可以（显式写明 "no open questions" 可接受；章节缺失不可接受）。
如果无法满足某项门禁标准，需在 "Open questions" 章节中明确标记该缺口，并在调用下一阶段之前向用户提出。
反模式
- 不要编造无法验证的资产。如果某物可能存在，标记为 "suspected — needs confirmation"，而不是断言其存在。
- 不要掩盖混乱。如果两个角色声称拥有同一资产，记录这一冲突——那本身就是摩擦点。
- 不要以 "it's complicated" 为由跳过流程映射。如果复杂，那是 Phase 2 要解决的问题。先映射现有内容。
- 不要在本阶段提出解决方案。解决方案属于 Phase 2（taxonomy）或 Phase 3（environment）。Phase 1 仅描述。
参考文件
- references/inventory-templates.md——常见 substrate 类型的示例盘点表
- references/friction-patterns.md——常见摩擦原型及示例
- references/value-metrics-frameworks.md——速度/准确性/利用率指标库