Immutable. This exact content is served forever at /api/v1/blob/0b00a330676206a8.
--- name: requirement-baseline description: 现状盘点 / 当前能力梳理 / 现有流程、页面、API、数据、运营规则盘点 / as-is audit / current state inventory —— 交付物是**现状清单本身**：现在怎么运作、已有哪些能力与例外、事实来源与 freshness、缺口和冲突，含按 commit 固定的代码现状取证。Skip 要的是意图、用户故事、验收标准、问题池（「到底要什么」）→ requirement-intent；要的是本轮改哪些、不改哪些、切几版（变更边界）→ requirement-scope；问线上是否已启用 → platform-observability；代码/项目质量评估 → product-rd-workflow；bug 根因 → defect-diagnosis。 --- # Requirement Baseline 把「现在到底怎么运作」变成一份有来源、有 freshness、缺口显式的 as-is 清单。改需求之前先弄清现状、已有能力是什么、缺口在哪里时进入本技能。 **选型与评估依赖现状事实时同样进本技能**：判断采用/扩展/替换/下线哪个组件、某能力是否已存在、某系统当下如何运作——结论落在别处（`product-rd-workflow` 的 gate），但支撑结论的事实归本技能取证，取证纪律见硬约束 1。 ## 硬约束（先读，全程适用） 1. **不下产品决策。** 只描述现状，不判断「应该怎么改」。代码、数据、架构等描述性证据**不裁决 should-be**。最高频的越界形态是**拿可用性证据当选型结论**：仓库活跃度、最近提交时间、「跑得起来」「有 API」「另一个候选已停更」只说明某物存在且能用，不说明它该被采用——这类事实照记，但不得推出「所以选它」。该记而常被略过的是候选的**自述定位**（README 首句、manifest 描述）——它出自制品自身，属现状事实；查不到就记「自述定位未查到」并列出已查来源，不得代拟。**层级归属分现状与目标两栏，不可混填**：现状层级按部署配置、依赖图等有来源的现状证据照记（这是本技能的本职，不因目标架构缺失而丢弃）；目标层级仅当有来源的目标架构**明确写到该候选**时才记，架构未确认与架构未涵盖该候选要分别记明，作为证据缺口交回决策 owner，不得靠推断补齐。 2. **三态判定，权威 baseline 不得记 N/A。** 用共享契约的 current-state 三态；新鲜权威 baseline 记 `satisfied-by-authoritative-baseline`。 3. **`not-applicable` 的全部前置条件**：仅当是有边界的存在性检查、**且**能证明净新增、**且**不触及既有流程、权限、数据、API、规则、迁移、兼容或旧版本行为时才可判。任一条不成立即不得判。 4. **未查到 ≠ 不存在。** 正常取证后仍未查到的能力、接口、数据、权限、审核流或模型能力，不得写成已确定字段；对应 requirement 行不得设为 `closed`。 5. **关闭表只补自己那部分。** 唯一 canonical 是 `requirement-doc-writer/references/requirement-closure-contract.md`。本技能以 `evidence-derived` 只填 as-is 描述性事实，或有效已批准规范性来源授权范围内的字段；记录 decision_authority、source、推导、冲突处置和重开条件，**只提出行状态候选，不得把整行设为 `closed`**。 ### 安全 4 问（命中即阻断） 现状涉及身份、计费、配额、租户/用户隔离、权限、删除、覆盖时，盘点必须逐项记录安全 4 问的现状答案（无命中则显式记"无安全敏感输入"）。命中上述任一项时，必须先读取 `requirement-doc-writer/references/security-four-questions.md`（问题本体与现状（as-is）应用细则 canonical）再作答，并在产物中写明所依据的 canonical 文件名 `security-four-questions.md`（实测：要求一段**固定字样**的旧写法命中率仅 20.5%，而逐项作答与写明来源文件分别可达 82% / 59%——本仓无法机械校验运行时产物，故只要求可核的实质，不要求不可核的字面戳）；凭记忆或转述作答、未写明来源、或命中后仍记"无命中"，均为违规。**读取不可得时（本会话无文件读取工具 / 文件缺失 / 读取失败）走这条路径，不得声称已读**：改写 `依据: 不可得(<原因>)`；按常驻反射尽力作答、本节标 `interim` 并写出解除方式，缺口连同风险标签交 `feature-risk-router`，由风险 owner 决定是否接受**推迟**——接受的是推迟、不是关闭：本节转正式关闭仍须真实读取 canonical 后逐项重答；agent 与需求提出方均不得自行判为已关闭。always-on 常驻反射见 agent-context/session-start.md「设计期安全 4 问」；本节只定义产物落点与交接。 命中后把风险标签和 gate 选择交给 `feature-risk-router`；需要研发改动时交给 `product-rd-workflow`。 ## 产出 | 模块 | 内容 | | --- | --- | | 事实来源 | 文档、界面、代码、配置、数据样例、运营规则、访谈记录；标注新旧和可信度 | | 用户路径 | 用户入口、步骤、状态变化、异常/回退路径 | | 系统路径 | 页面/API/服务/数据/规则之间的链路；不确定处标注 | | 已有能力 | 已可用能力、约束、默认行为、例外规则；盘点对象是候选组件/服务时另记其自述定位（查不到就填「自述定位未查到」并列出已查来源，不得留空或代拟），层级归属分现状栏与目标栏：现状栏只填有来源的现状证据（部署配置、依赖图等），目标栏仅在目标架构明确写到该候选时填，否则按「架构未确认」与「架构未涵盖该候选」分别记明，两栏都不得填推断值 | | 缺口 | 与目标或问题陈述不匹配的空白、冲突、重复能力 | | 风险/不确定 | 事实不足、过期来源、权限/数据/删除/覆盖风险 | | 需求点关闭表 | 按共享契约补事实依据、freshness、冲突和证据缺口 | ## Workflow 1. 判定 current-state 三态：记录存在性检查范围；硬约束 3 的任一前置条件不成立时，不得判 `not-applicable`。 2. 定义盘点对象：流程、页面、API、数据、规则、角色或能力边界。 3. 主动查证：按共享契约完成一轮有界取证 pass；记录已查类别和未查原因，不假设未授权网络、生产或客户数据访问。 4. 核验权威性、freshness 与适用范围：同等级权威产品来源冲突时立即升级；新权威源替代旧非权威源时记录冲突处置和重开条件。 5. 画用户路径和系统路径，列出现有行为、入口、条件、限制和例外。 6. 标缺口、冲突和风险：事实不足、目标不匹配、重复能力、规则矛盾和安全命中项分开写。 7. 更新 `需求点关闭表`（按硬约束 5 的字段权限）。 8. 交接决策 owner：把完整关闭表交回 lifecycle、`requirement-intent`、`requirement-scope`、`defect-diagnosis` 或风险 gate。 ## 不用本技能，改用谁 - 要「到底要什么」（意图、用户故事、验收标准、问题池）→ `requirement-intent`。 - 要变更边界（in/out、切片、appetite）→ `requirement-scope`；多阶段交付 → `product-rd-workflow`。 - 问某能力线上是否已启用、要实时指标 → `platform-observability`。**代码里存在 ≠ 已部署启用**。 - 代码质量、架构质量、项目整体评估 → `product-rd-workflow` 分派 stack/architecture/testing/UI owner。 - bug、线上症状、失败测试、根因定位 → `defect-diagnosis`。 - 风险 tag / gate 选择 → `feature-risk-router`。 - 只润色已成文的盘点报告 → `tighten-doc`。 ## 完成标准 逐条可核，缺一条即为 `interim` 而非完成： - 每条现状结论都有具名来源，并标了 freshness 与可信度；无来源的结论标为未确认。 - 已查类别与**未查类别及其原因**都写出来了；未解析来源单独列出。 - 盘点对象含候选组件/服务时，每个候选都记了自述定位、或记了「未查到」并列出已查来源；层级归属分现状与目标两栏——现状层级凡有来源现状证据的都记了，目标层级只在目标架构明确写到该候选时才记，另两种缺口（架构未确认／架构未涵盖该候选）分别记明而非留空或臆测。没有任何结论由活跃度、可运行性或「另一候选已停更」单独推出。 - 三态判定已记录；若判 `not-applicable`，硬约束 3 的每条前置条件都逐条写明成立依据。 - 缺口、冲突、风险三者分开列，未混进「已有能力」。 - 关闭表只填了 `evidence-derived` 允许的字段，且没有任何整行被设为 `closed`。 - 安全 4 问：记了「无命中」，或四项逐条答案 + 写明所依据的 canonical 文件名；读取不可得时写了 `不可得(<原因>)` 并把本节标 interim。 ## 输出模板 ```text 现状盘点 - 盘点对象： - 事实来源： - 用户路径： - 系统路径： - 已有能力： - 缺口 / 冲突： - 风险 / 不确定： - 未解析来源 / 未查类别及原因： - 需求点关闭表： - 安全 4 问：无命中 / <逐项作答四项> - 依据来源：<读到了写 `security-four-questions.md`；没读到写 `不可得(<原因>)` 并把本节标 interim。不得留空> - 下一步 owner： ```