dsh-crwu-workbench 0.0.10

package/skills/crwu/crwu-audit-external-data/scripts/test_connector_probe.py

@@ -0,0 +1,264 @@
+#!/usr/bin/env python3
+"""connector_probe 的单元测试（纯标准库；用临时目录造假宿主配置，不触碰真实凭据）。
+
+`connector_probe.py` 只探测一类事实：**WorkBuddy 宿主连接器声明**（`ifind-mcp`）。
+它不再搜索、不再判断任何 DSH 技能目录 —— DSH 侧的取数入口是宿主的结构化 Tool，
+可见性由宿主决定，不属于本探测器。因此这里只覆盖 WorkBuddy 行为，并额外锁死
+"探测器里不得再出现技能探测接口与字段"这条实现边界。
+
+本测试只依赖同目录的 connector_probe.py —— 本技能单独安装时也能通过。
+"""
+from __future__ import annotations
+
+import contextlib
+import inspect
+import io
+import json
+import os
+import re
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+import connector_probe as probe  # noqa: E402
+
+PROBE_SOURCE = Path(__file__).resolve().parent / "connector_probe.py"
+
+FAKE_TOKEN = "FAKE-SECRET-TOKEN-1234567890"
+
+# 实现边界：这些标识只属于已删除的 DSH 技能探测路径，源码里不得再出现
+# （含注释）。扫描覆盖整个文件，不区分代码与注释。
+FORBIDDEN_MARKERS = (
+    "ifind-finance-data",
+    "HARNESS_SKILL_ID",
+    "SKILLS_ROOT_ENV",
+    "DEFAULT_SKILLS_ROOTS",
+    "find_harness_skill",
+    "classify_skill",
+    "call\\.py",
+    "call-node\\.js",
+    "mcp_config\\.json",
+    "--skills-root",
+    "harnessSkill",
+    "harness_skill",
+)
+
+# 旧输出里属于 DSH 技能路径的字段，必须一个都不剩。
+FORBIDDEN_RESULT_KEYS = ("skillsRoots", "harnessSkill", "harnessSkillVerdict", "harness_skill")
+
+
+def write_json(path: Path, payload) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(payload, ensure_ascii=False), encoding="utf-8")
+
+
+def build_root(
+    root: Path,
+    *,
+    declare_ifind: bool = True,
+    ifind_disabled: bool | None = None,
+    enabled: list | None = None,
+    stored_auth: list | None = None,
+    ever: list | None = None,
+    auth_mode: str = "server-side",
+) -> None:
+    """造一个 WorkBuddy 风格的宿主连接器根目录。"""
+    servers = {}
+    if declare_ifind:
+        entry = {"url": "https://api-mcp.51ifind.com:8643/ds-mcp-servers/hexin-ifind-mcp?token=%s" % FAKE_TOKEN}
+        if ifind_disabled is not None:
+            entry["disabled"] = ifind_disabled
+        servers["connector:ifind-mcp"] = entry
+    write_json(root / "mcp.json", {"mcpServers": servers})
+
+    state_dir = root / "connectors" / "00000000-1111-2222-3333-444444444444"
+    write_json(
+        state_dir / "connector-states.v3.json",
+        {
+            "enabled": enabled if enabled is not None else ["ifind-mcp"],
+            "userDisabled": {},
+            "everConnected": ever if ever is not None else ["ifind-mcp"],
+            "headerOverrides": {
+                name: {"Authorization": {"iv": "x", "ct": FAKE_TOKEN}}
+                for name in (stored_auth if stored_auth is not None else ["ifind-mcp"])
+            },
+        },
+    )
+    write_json(
+        root / "connectors-marketplace" / ".codebuddy-connector" / "connectors.json",
+        {
+            "connectors": [
+                {"id": "ifind-mcp", "name_zh": "同花顺iFinD金融数据查询", "auth_mode": auth_mode},
+            ]
+        },
+    )
+
+
+class ProbeTest(unittest.TestCase):
+    def test_host_connector_available(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            result = probe.probe(root)
+            ifind = result["targets"]["ifind"]
+            self.assertEqual("available", ifind["state"])
+            self.assertEqual("host_connector", ifind["accessPath"])
+            self.assertEqual("ifind-mcp", ifind["connectorId"])
+            self.assertEqual("api-mcp.51ifind.com", ifind["endpointHost"])
+            self.assertEqual("stored_authorization", ifind["authEvidence"])
+
+    def test_catalog_only_connector_is_not_declared(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root, declare_ifind=False, enabled=[], stored_auth=[])
+            ifind = probe.probe(root)["targets"]["ifind"]
+            self.assertEqual("not_declared", ifind["state"])
+            self.assertIn("目录", ifind["reason"])
+
+    def test_connector_declared_but_disabled(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root, ifind_disabled=True, enabled=[], stored_auth=[])
+            self.assertEqual("declared_disabled", probe.probe(root)["targets"]["ifind"]["state"])
+
+    def test_connector_not_in_enabled_list_is_disabled(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root, enabled=[], stored_auth=["ifind-mcp"])
+            self.assertEqual("declared_disabled", probe.probe(root)["targets"]["ifind"]["state"])
+
+    def test_other_account_state_disabled_does_not_override_active_state(self):
+        """真实场景：connectors/default 把 ifind 标为 disabled=true，但当前账号态已启用且连过。"""
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            write_json(
+                root / "connectors" / "default" / "mcp.json",
+                {
+                    "mcpServers": {
+                        "connector:ifind-mcp": {
+                            "url": "https://api-mcp.51ifind.com:8643/ds-mcp-servers/hexin-ifind-mcp",
+                            "disabled": True,
+                        }
+                    }
+                },
+            )
+            result = probe.probe(root)
+            self.assertEqual("connectors/00000000-1111-2222-3333-444444444444", result["activeStateScope"])
+            self.assertEqual("available", result["targets"]["ifind"]["state"])
+
+    def test_missing_everything_is_reported_not_guessed(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            missing = Path(tmp) / "nope"
+            result = probe.probe(missing)
+            self.assertFalse(result["rootExists"])
+            self.assertEqual("not_declared", result["targets"]["ifind"]["state"])
+            buffer = io.StringIO()
+            with contextlib.redirect_stdout(buffer):
+                code = probe.main(["--root", str(missing), "--format", "json"])
+            self.assertEqual(2, code)
+            self.assertEqual([], json.loads(buffer.getvalue())["connectors"])
+
+    def test_main_returns_zero_when_connector_available(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            buffer = io.StringIO()
+            with contextlib.redirect_stdout(buffer):
+                code = probe.main(["--root", str(root), "--format", "json"])
+            self.assertEqual(0, code)
+            self.assertEqual("host_connector", json.loads(buffer.getvalue())["targets"]["ifind"]["accessPath"])
+
+    def test_token_auth_without_evidence_exits_two(self):
+        """已声明且启用、但授权形态是 token 且无任何授权证据 → 预检不可用（退出码 2）。"""
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root, stored_auth=[], ever=[], auth_mode="token")
+            buffer = io.StringIO()
+            with contextlib.redirect_stdout(buffer):
+                code = probe.main(["--root", str(root), "--format", "json"])
+            self.assertEqual(2, code)
+            self.assertEqual("likely_unauthenticated", json.loads(buffer.getvalue())["targets"]["ifind"]["state"])
+
+    def test_never_leaks_credentials(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            result = probe.probe(root)
+            payload = json.dumps(result, ensure_ascii=False)
+            self.assertNotIn(FAKE_TOKEN, payload)
+            self.assertNotIn('"Authorization"', payload)
+            self.assertNotIn(FAKE_TOKEN, probe.render_text(result))
+
+    def test_text_format_excludes_wind(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            text = probe.render_text(probe.probe(root))
+            self.assertIn("同花顺 iFinD", text)
+            self.assertNotIn("万得", text)
+            self.assertNotIn("wind", text.lower())
+
+    def test_env_var_supplies_default_connector_root(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            buffer = io.StringIO()
+            old = os.environ.get(probe.DEFAULT_ROOT_ENV)
+            os.environ[probe.DEFAULT_ROOT_ENV] = str(root)
+            try:
+                with contextlib.redirect_stdout(buffer):
+                    code = probe.main(["--format", "json"])
+            finally:
+                if old is None:
+                    os.environ.pop(probe.DEFAULT_ROOT_ENV, None)
+                else:
+                    os.environ[probe.DEFAULT_ROOT_ENV] = old
+            self.assertEqual(0, code)
+            self.assertEqual("available", json.loads(buffer.getvalue())["targets"]["ifind"]["state"])
+
+    # ---- 以下用例锁定"探测器只探测 WorkBuddy"这条实现边界 ----
+
+    def test_probe_signature_takes_only_the_connector_root(self):
+        """`probe()` 只接宿主连接器根；skills 根形参不是可选项，而是必须不存在。"""
+        parameters = list(inspect.signature(probe.probe).parameters)
+        self.assertEqual(["root"], parameters, "probe() must only accept the WorkBuddy connector root")
+
+    def test_cli_no_longer_accepts_skills_root(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            stderr = io.StringIO()
+            with contextlib.redirect_stderr(stderr):
+                with self.assertRaises(SystemExit) as caught:
+                    probe.main(["--root", tmp, "--skills-root", tmp, "--format", "json"])
+            self.assertEqual(2, caught.exception.code, "argparse must reject the removed --skills-root option")
+
+    def test_result_json_has_no_skill_path_fields(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            result = probe.probe(root)
+            for key in FORBIDDEN_RESULT_KEYS:
+                self.assertNotIn(key, result, "probe result must not expose %s" % key)
+                self.assertNotIn(key, result["targets"]["ifind"], "ifind target must not expose %s" % key)
+            self.assertNotEqual("harness_skill", result["targets"]["ifind"]["accessPath"])
+
+    def test_render_text_has_no_skill_path_lines(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            root = Path(tmp) / "workbuddy"
+            build_root(root)
+            text = probe.render_text(probe.probe(root))
+            for marker in ("skillsRoots", "Harness 技能根", "Harness 技能：", "harness_skill"):
+                self.assertNotIn(marker, text, "text rendering must not mention %s" % marker)
+
+    def test_source_has_no_dsh_skill_probe_markers(self):
+        """实现边界硬判据：源码（含注释）不得再出现技能探测路径的任何标识。"""
+        source = PROBE_SOURCE.read_text(encoding="utf-8")
+        hits = sorted({marker for marker in FORBIDDEN_MARKERS if re.search(marker, source)})
+        self.assertEqual([], hits, "connector_probe.py must not contain: %s" % ", ".join(hits))
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/crwu/crwu-audit-output-filter/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: crwu-audit-output-filter
+description: Use when crwu-audit is preparing its final phase-one findings and must remove reviewer-approved, low-value opinion types through the live suppression checklist.
+---
+
+# 审核意见输出过滤
+
+## 调用边界
+
+仅经 `crwu-audit` router 编排调用，禁止单独调用。本技能是恒加载的 `public` 轴后处理能力：不产生审核意见、不改变专业判断，只在全部候选审核意见汇总完成后、阶段一冻结前，按知识库《02-屏蔽清单》过滤不进入正式审核结果的意见。
+
+本技能只读取运行时清单，不读取《01-维护规则》。维护规则供人员维护知识库使用，不属于每次审核的运行材料。
+
+## 输入
+
+- 已完成归并、尚未冻结的候选审核意见；
+- 每条候选意见的稳定匹配标识：优先使用 `checkId`；无 Check ID 时使用受控的 `字段编号:问题类型`；
+- router 已确定的资产、业务、方法、监管覆盖和审核阶段；
+- 经 `crwu-dws` 本次实时下载并验证的《02-屏蔽清单》。
+
+缺少或无法读取屏蔽清单时，不执行任何屏蔽，保留全部候选意见并记录 capability gap。不得沿用上一轮清单或凭记忆过滤。
+
+## 必读 references
+
+1. [00-applicability.md](references/00-applicability.md)：适用范围和失败降级；
+2. [01-kb-assembly.md](references/01-kb-assembly.md)：本次只下载运行时屏蔽清单；
+3. [02-review-focus.md](references/02-review-focus.md)：精确匹配、例外和输出纪律。
+
+## 执行结果
+
+- 命中启用记录，且同时满足适用范围与屏蔽条件、未命中不屏蔽例外：该候选意见不进入正式审核结果；
+- 未命中、匹配冲突、条件不完整或无法判断：保留候选意见；
+- 屏蔽动作不得改写其他意见的事实、严重度、证据或 `source_skills[]`；
+- 正式交付不得逐条展示已屏蔽意见，也不得用摘要、备注或“其他轻微问题”等措辞变相输出其内容。

package/skills/crwu/crwu-audit-output-filter/references/00-applicability.md

@@ -0,0 +1,7 @@
+# 适用范围
+
+本能力对所有 `crwu-audit` 审核恒适用，与报告形态、资产、业务、方法和监管标签无关。
+
+适用对象是全部审核能力已经完成后形成的候选审核意见；不得在专业能力执行前预先裁剪检查项，也不得改变对象、业务、方法或监管技能的检查范围。
+
+运行时清单为空时正常零屏蔽。清单缺失、下载失败、格式不可判定或存在冲突时，保留全部候选意见并记录 capability gap；不得因此停止其他审核能力或整单审核。

package/skills/crwu/crwu-audit-output-filter/references/01-kb-assembly.md

@@ -0,0 +1,11 @@
+# 审核意见屏蔽清单装配
+
+本技能只装配运行时《02-屏蔽清单》；《01-维护规则》供人员维护知识库使用，不进入每次审核下载清单。
+
+单文件路径逐字使用知识库节点名，不加 `.md` 后缀。运行时由 `crwu-dws` 实时下载正文，不读取跨审核缓存。
+
+| source_key | owner_axis | canonical_label | kb_root | request_kind | recursive | required |
+| --- | --- | --- | --- | --- | --- | --- |
+| `OUTPUT_SUPPRESSION_CHECKLIST` | `public` | `审核意见屏蔽` | `06-规则库/04-AI审核意见屏蔽/02-屏蔽清单` | `file` | `false` | `true` |
+
+下载失败时本技能降级为零屏蔽，保留全部候选意见并记录 capability gap；不得猜测近似路径或读取《01-维护规则》替代。

package/skills/crwu/crwu-audit-output-filter/references/02-review-focus.md

@@ -0,0 +1,25 @@
+# 输出过滤规则
+
+## 1. 读取有效记录
+
+只读取《02-屏蔽清单》表格中 `状态=启用` 的记录。停用、字段缺失或表格无法解析的记录不执行。
+
+## 2. 精确匹配
+
+每条候选意见先形成稳定 `匹配标识`：
+
+- 有 `checkId`：直接使用该编号；
+- 无 `checkId`：仅使用已有受控字段编号构成 `字段编号:问题类型`；
+- 禁止仅凭相似措辞、自由文本关键词或语义猜测扩大匹配。
+
+## 3. 条件与例外
+
+精确命中后，依次核对适用范围和屏蔽条件。任一条件不满足，或命中“不屏蔽例外”，均保留意见。
+
+同一意见同时命中屏蔽和保留条件时，以保留为准。无法判断时也以保留为准。
+
+## 4. 输出纪律
+
+满足全部条件的候选意见不进入正式 `issues[]`，也不进入员工 HTML 的问题、摘要、建议或备注区域。不得变相输出被屏蔽意见的具体内容。
+
+本能力只过滤正式输出，不把屏蔽规则解释成专业结论，也不为其他候选意见增删证据或改变严重度。

package/skills/crwu/crwu-audit-public-general-standards/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: crwu-audit-public-general-standards
+description: Use when crwu-audit has selected the public 通用准则 capability for report-disclosure and procedure/quality-control review.
+---
+
+# 通用准则公共审核（报告披露 · 程序与质控）
+
+## 调用边界
+
+仅经 `crwu-audit` router 编排调用，禁止单独调用。本技能是 `public` 轴叶子，只审核**报告形态无关的通用准则层**：报告与披露要求、评估程序执行要求、机构质量控制要求。不查询报告记录、不准备材料、不重新下载规则，也不替代任何专业轴技能。
+
+本能力的执行契约见 [执行契约](references/03-execution-contract.md)：输入边界、执行顺序、条目状态、来源优先级、证据字段与 capability gap 均按该文件执行。本技能**只读取自己目录内的文件**，不读取任何 sibling Skill；资产/业务叶子共同约束里的轴边界、一级根装配与二级选择**对本能力不适用**。
+
+- 对象专业事项（权属、实物与经济特征、对象特有方法前提）由 `crwu-audit-asset-*` 处理；
+- 评估目的与经济行为对口径、材料、判断的影响由 `crwu-audit-biz-*` 处理；
+- 方法与监管正文由 method / overlay 轴处理；表格勾稽由 `crwu-audit-datacheck` 处理；
+- 本技能**不替代**上述任何一轴，也不因某专业轴 `pending` 而停止执行。对象、业务、方法、监管全部缺失时，本技能仍须独立产出通用准则层的检查结果。
+
+本技能对**任何报告形态恒适用**，因此由 router 在公共能力求值阶段无条件并入 `public_skills[]`，不依赖材料类型条件。
+
+## 输入
+
+- 同一份 `route_profile`（五轴标签与证据；本技能不消费具体专业标签，只用 `report_form`、`record_context` 与材料分区）；
+- router 已准备并隔离的报告、评估说明、测算明细表等材料路径；
+- router 已验证的本次 DWS manifest、规则快照及其文件路径。
+
+缺少上述输入时记录 capability gap，不自行补取、猜测或沿用上一轮材料。
+
+## 必读 references
+
+执行前依次读取：
+
+1. [00-applicability.md](references/00-applicability.md)：确认本公共能力的适用、排除与边界；
+2. [01-kb-assembly.md](references/01-kb-assembly.md)：核对本次规则快照覆盖的 RULE 与库内层级路径；
+3. [02-review-focus.md](references/02-review-focus.md)：按报告披露层与程序质控层的关注点实施检查；
+4. [03-execution-contract.md](references/03-execution-contract.md)：本能力自包含执行契约（输入边界、执行顺序、条目状态、来源优先级、证据字段、capability gap）。
+
+## 执行与输出
+
+1. 用 `00-applicability.md` 界定本次适用范围；不改变 router 已确定的任何轴标签。
+2. **先判规则版本**：程序准则与质控指南存在新旧两版且施行日期不同，按报告基准日／报告日所属期间选定整段引用版本，禁止新旧条款混引（判定规则见 `02-review-focus.md` §1）。版本无法确定时记录冲突并转人工判断，不任选一版。
+3. 用本次 DWS manifest 验证 `01-kb-assembly.md` 所需文件；缺失项按路径和原因记录 gap，对应检查不引用、不编造。
+4. 按 `02-review-focus.md` 分别审核报告、评估说明、测算明细表；报告披露层与程序质控层各自独立出条目状态，不以"未发现问题"笼统概括。
+5. 索引卡类文件**不构成规则条目**，不得作为引用依据；模板参考类文件只做格式基线对照，判定以准则正文条款为准。
+6. 输出通用准则层 findings；每条均带 `source_skills[]`，其中至少包含 `crwu-audit-public-general-standards`。相同事实由其他技能共同支持时保留全部来源，冲突时并列交人工复核。
+7. 按本次 DWS 执行契约输出证据与修改建议；出处包含本次下载文件、实际行号、库内路径、本次运行返回的 `nodeId` 和 `exportedAt`（运行时值不写回本技能）。

package/skills/crwu/crwu-audit-public-general-standards/references/00-applicability.md

@@ -0,0 +1,41 @@
+# 通用准则公共能力适用与边界
+
+## Canonical 标签
+
+- canonical：`通用准则`
+- 轴：`public`（报告形态无关的公共能力，不入专业轴）
+- 装配语义：命中即**无条件加载**，与对象、业务、方法、监管标签是否命中或 `pending` 无关。
+
+## 纳入范围
+
+本能力覆盖两层，两层各自独立执行、独立出条目状态：
+
+| 层 | 覆盖内容 | 规则来源装配键 |
+| --- | --- | --- |
+| 报告披露层 | 报告结构要素、正文要素、声明、摘要、使用人、评估目的唯一性、对象与范围载明、价值类型、基准日一致性、评估依据、方法与理由、假设披露、结论表述、特别事项、使用限制、报告日、附件 | `PUBLIC_REPORT_DISCLOSURE_ROOT` |
+| 程序与质控层 | 评估程序各环节的执行与留痕要求、程序缺失处理、内部／分级审核、报备一致性、档案归集；机构层面质量控制体系、审核人员独立性、记录与档案、信息技术与 AI 使用边界 | `PUBLIC_PROCEDURE_QUALITY_ROOT` |
+
+两层同时适用时**全部保留**，不因命中其一而省略另一层。
+
+## 与专业轴的接口
+
+本能力只审"通用准则要求本身是否被满足"，不代替专业判断：
+
+- 报告是否载明评估方法及其理由 → 本能力检查**载明与披露完整性**；方法选取是否恰当 → method 轴；
+- 报告是否载明程序受限情况及处理方式 → 本能力检查**说明义务**；受限对结论的影响程度是否成立 → 由对象／方法轴结合材料判断；
+- 报告是否载明特别事项 → 本能力检查**七类披露完整性**；事项本身对评估结论的影响 → 对应专业轴；
+- 分级审核记录是否留存、审核人员是否独立 → 本能力检查**机构层面合规**；具体检查点内容是否命中 → 由执行该检查的专业轴产出。
+
+同一事实被多个技能共同支持时合并 finding 并保留全部 `source_skills[]`；结论冲突时并列交人工复核，不以后加载来源覆盖。
+
+## 边界与不适用
+
+- 库内**索引卡**类节点（登记元数据与编撰规划的说明页）不构成规则条目，**不得作为审核引用依据**；仅在需要说明"某准则尚未精编"时作为内容缺口证据。
+- 模板参考类节点（封面／文号／声明样稿样式）只做格式基线对照，**判定一律以准则正文条款为准**，不得据模板文件出规则性缺陷结论。
+- 规则条目自带发布状态与时效信息时，只采用其**当前有效**版本；已废止版本仅在审核该版本适用期间的报告时引用。
+- 被审材料是咨询报告、估值文书等非评估报告形态时，报告准则条款的适用性需按报告形态另行确认，不适用范围不得强行套用。
+
+## 待确认项
+
+- 报告准则体系在准则重构期是否修订处于跟踪状态，报告日跨重构节点的项目需确认所适用版本。
+- 程序准则与质控指南的旧版精编状态不一致（详见 `02-review-focus.md` §1 与 §5），2026 年内报告的程序/质控对照依据存在内容缺口，按 gap 如实登记，不补造。

package/skills/crwu/crwu-audit-public-general-standards/references/01-kb-assembly.md

@@ -0,0 +1,66 @@
+# 通用准则规则装配
+
+**路径键写法**：逐字使用库内节点名（`crwu-dws` 的 `by_path` 键 = 原样精确名，不做大小写/全半角折叠）。**单文件路径不要加 `.md` 后缀**——`.md` 只是导出到本地时的文件名（`<节点名>.md`），不是库内节点名；带后缀会与 `by_path` 键不匹配而在 M2 记 failure。目录路径以 `/` 结尾并递归下载。
+
+本表只保存 RULE/CHK 编号和库内层级路径寻址键。运行时由 `crwu-audit` 汇总清单，再由 `crwu-dws` 实时下载正文并生成本次 manifest；目录缓存只用于定位，正文文件零缓存，不得读取上一轮下载物。
+
+清单条目有两种语义：不以 `/` 结尾的是单文件路径，只下载该文件；以 `/` 结尾的是目录路径，**递归下载其中全部支持正文**。清单外零下载。
+
+## 1. 装配映射（公共轴：两个根 + 一个单文件 + 一个清单根）
+
+| source_key | owner_axis | canonical_label | kb_root | request_kind | recursive | required |
+| --- | --- | --- | --- | --- | --- | --- |
+| `PUBLIC_REPORT_DISCLOSURE_ROOT` | `public` | `通用准则` | `06-规则库/02-通用准则-报告与披露/` | `directory` | `true` | `true` |
+| `PUBLIC_PROCEDURE_QUALITY_ROOT` | `public` | `通用准则` | `06-规则库/03-通用准则-程序与档案/` | `directory` | `true` | `true` |
+| `PUBLIC_BASIS_CURRENCY_CHECK` | `public` | `通用准则` | `06-规则库/01-监管规则与口径/依据时效对照表` | `file` | `false` | `true` |
+| `PUBLIC_PITFALL_LIBRARY_ROOT` | `public` | `通用准则` | `06-规则库/易错点库/` | `directory` | `true` | `true` |
+
+四项均为 `required=true`：报告披露层、程序质控层与依据时效判定对任何报告形态恒适用，**易错点库（PIT 条目）为跨对象跨业务的复核反馈沉淀，须对全体项目可见**（此前仅由 `crwu-audit-asset-realestate` 装配 → 其余 11 个资产类型读不到）。
+命中本能力即按下表下载，不逐文件挑选、不按对象或方法条件裁剪。
+
+- `PUBLIC_BASIS_CURRENCY_CHECK` 是**单文件**：只下载该文件本身（不带 `.md` 后缀、不以 `/` 结尾）；
+  它是 `02-review-focus.md` §2「依据章节的三类可判定缺陷」的判定依据（`RULE-01-03-001~030`），**不是可选参考**。
+
+## 2. expected_structure 断言
+
+**`PUBLIC_REPORT_DISCLOSURE_ROOT`**（2026-09-10 本次实时目录核对）：
+
+- `报告准则-精编条目/`：`README`、`报告准则-总则与基本遵循`、`报告准则-报告内容与附则`、`报告准则-附件格式与声明样稿-参考`；
+- `资产评估报告准则`（索引卡：登记元数据与编撰规划，**不构成规则条目、不作引用依据**）。
+
+覆盖 `RULE-01-02-251~279`：`报告准则-总则与基本遵循` = 251~260（第一至十条），`报告准则-报告内容与附则` = 261~279（第十一至二十九条）。
+
+**`PUBLIC_PROCEDURE_QUALITY_ROOT`**：
+
+- `程序准则2018-精编条目/`：`README`、`程序准则旧版2018-总则基本遵循与实施要求上`、`程序准则旧版2018-实施要求下与附则` → `RULE-01-02-101~115`、`RULE-01-02-116~127`；
+- `程序准则2026-精编条目/`：`README`、`程序准则2026-第一章总则与第二章基本遵循`、`程序准则2026-第三章实施要求-上`、`程序准则2026-第三章实施要求-下与第四章附则` → `RULE-01-02-001~007`、`RULE-01-02-008~019`、`RULE-01-02-020~028`；
+- `质控指南2026-精编条目/`：`README`、`质控指南-总则质量控制责任`、`质控指南-职业道德人力资源承接计划`、`质控指南-实施审核与监控等` → `RULE-01-02-401~417`、`RULE-01-02-418~434`、`RULE-01-02-435~456`；
+- 索引卡类（**不构成规则条目、不作引用依据**）：`机构业务质量控制指南2026-6号`、`资产评估程序准则2026版`、`资产评估执业准则-利用专家工作及相关报告-索引卡`。
+
+库内若缺其中某项，按实际下载结果执行并记**知识库内容缺口**，不据目录名猜测替代路径。
+
+**`PUBLIC_BASIS_CURRENCY_CHECK`**（单文件；2026-09-16 本次实时目录核对，`extension=adoc`）：
+
+- `依据时效对照表`：`RULE-01-03-001~003`（三类判定口径：版本过期／分类错位／适用性存疑）+ `RULE-01-03-004~030`（逐条对照）。
+- 表内标注 `核验状态=待官方核验` 的行，出意见前须先比对官方原文（见 `02-review-focus.md` §2）。
+- 该文件缺失时按 §5 记 gap 并转人工，**不凭经验判定版本新旧**。
+
+**`PUBLIC_PITFALL_LIBRARY_ROOT`**（2026-09-16 本次实时目录核对）：
+
+- `首批易错点`：`PIT-001~030`（错误表现／依据／正确做法·检查动作／历史命中）；
+- `README`：易错点条目三要素与引用资格说明。
+- 易错点本身不创造规则，须挂 ≥1 条 `RULE-*` A 级条目；未挂依据者只作 B/C 级提示，不作硬依据。
+
+## 3. 版本选择（本轴特有，装配后立即适用）
+
+两个根内**同时存在新旧两版**程序准则，施行期间不同，装配后必须先按报告的基准日／报告日选定版本（判定规则与登记状态见 `02-review-focus.md` §1）。禁止把两版条目混引；禁止用尚未施行的版本倒查在该版本施行前出具的报告。
+
+## 4. 不装配的内容
+
+- 机构内部制度文本：不在本技能范围（机构层面制度对照属部署方与知识库其他目录）。
+- 方法与监管覆盖正文：属 method / overlay 轴；财务报告覆盖规则是按 `business_types[]=财务报告` 追加的业务补充包。它们均由 router 按命中标签动态装配，本技能只登记公共准则层与上表四项的寻址键。
+- 表格勾稽口径：属 public 轴 `crwu-audit-datacheck`，与工程执行契约一并由其装配。
+
+## 5. 失败与出处
+
+下载零命中、多命中、类型不符、跳过或失败时，以 manifest 状态记录对应 gap，不猜测近似路径。最终出处按 R6 由 manifest 与本次下载物共同形成：本次下载文件、实际行号、库内路径、运行时 `nodeId` 和 `exportedAt`；运行时值不得写回本文件。

package/skills/crwu/crwu-audit-public-general-standards/references/02-review-focus.md

@@ -0,0 +1,111 @@
+# 通用准则审核要点（报告披露层 · 程序质控层）
+
+> 本文件为**本次实时下载正文后归纳**的审核要点，不复制知识库正文。要点只回指 RULE 编号与库内层级路径寻址键；判定一律以本次下载的规则条目原文为准。
+
+## 1. 版本选择门禁（执行前置，先判后审）
+
+库内同时存在新旧两版程序准则，施行期间不同，**必须按报告的基准日／报告日所属期间整段选定版本**：
+
+| 规则族 | RULE 编号 | 施行状态 | 2026 年内报告的适用依据 |
+| --- | --- | --- | --- |
+| 报告准则（中评协〔2018〕35 号） | `RULE-01-02-251~279` | 自 2019-01-01 施行，现行 | **适用** |
+| 程序准则旧版（中评协〔2018〕36 号） | `RULE-01-02-101~127` | 至 **2026-12-31 仍现行**，2027-01-01 废止 | **适用** |
+| 程序准则新版（中评协〔2026〕5 号） | `RULE-01-02-001~028` | 自 **2027-01-01 施行** | **不适用**（不得倒查） |
+| 质控指南（中评协〔2026〕6 号） | `RULE-01-02-401~456` | 自 **2027-01-01 施行** | **不适用**（旧版未精编，见 §5） |
+
+纪律：
+
+- 禁止新旧条款混引；禁止用 2027-01-01 才施行的条目审查此前出具的报告。
+- 新旧版存在实质差异，按选定版本核查，**不得以新版新增要求倒查旧版期间报告**。已核实的差异点（旧版为对照基准）：
+  - 基本程序环节：旧版 7 环节（`101~115` 范围内第五条）→ 新版 9 环节并单列"不得随意减少"（`008~019` 范围内第五条、第六条）；
+  - 程序缺失处理：旧版仅"不得出具"限则 → 新版增加告知委托人、底稿记录限制情形／弥补措施／影响分析、报告披露三项（对应 `RULE-01-02-106` 与 `RULE-01-02-006`）；
+  - 内部审核：旧版为"对初步报告进行内部审核"（`RULE-01-02-123`）→ 新版升级为分级审核并对过程与结果详细记录（`RULE-01-02-023`）；
+  - 出具前沟通：旧版无"调整后再次审核"（`RULE-01-02-124`）→ 新版新增（`RULE-01-02-024`）；
+  - 业务报备：旧版无 → 新版新增"先报备后出具、与报备系统一致"（`RULE-01-02-026`）；审旧版报告不查报备一致（`RULE-01-02-125`）；
+  - 档案：旧版无涉密档案专项表述（`RULE-01-02-126`）→ 新版新增保密法衔接（`RULE-01-02-027`）。
+- 版本无法从材料确定时，记录冲突双方并转人工判断，不任选一版。
+
+## 2. 报告披露层检查维度（`RULE-01-02-251~279`）
+
+**基准与编制**：内容清晰准确、不得有误导性表述（`254`）；必要信息充分使使用人能正确理解结论（`255`）；详略程度与对象复杂程度、委托人要求相称（`256`，属**防误报**条目——简单项合理精简不构成缺陷）；中文撰写与币种计量、外币须注基准日汇率（`259`）。
+
+**签署与时效**：至少两名承办该项业务的资产评估专业人员签名并加盖机构印章，法定业务须至少两名资产评估师签名（`258`）；报告是否载明评估结论使用有效期，基准日与经济行为实现日相距通常不超过一年（`260`）。
+
+**结构与要素**（M-报告披露清单主干）：报告结构六要素完整性（`261`）；声明章节逐项核查（`262`）；摘要（`263`）；**正文十四要素核对，缺失任一要素即"要素不全"**（`264`）；附件五类核对（`278`）。
+
+**载明事项**：使用人界定（`265`）；**评估目的唯一性——多目的并存表述即缺陷**（`266`）；评估对象与范围载明（`267`）；价值类型的理由与定义（`268`）；**报告基准日与合同基准日一致**（`269`）；评估依据四类（法律法规／准则／权属／取价）载明，并核查是否引用已废止或过时文件（`270`）。
+
+**依据章节的三类可判定缺陷**（`270` 的落地口径，逐类出条目、不得合并成"依据不完整"一句）：
+
+| 类别 | 判据 | 证据要求 |
+| --- | --- | --- |
+| **版本过期** | 所列文件已被修订／废止／为新法取代（例：增值税暂行条例已被增值税法取代；公司法 2018 版已被 2023-12-29 修订版取代；财政部令第 86 号已被第 97 号取代） | 报告位置 + 所引版本原文 + 现行版本名称与施行日期 |
+| **分类错位** | 依据未按「准则依据／法律法规依据／其他参考依据」三分法归位（例：企业会计准则基本准则被放入法律法规依据；专家指引、监管规则适用指引被放入准则依据） | 报告位置 + 现归类 + 应归类 |
+| **适用性存疑** | 所列文件与本项目评估目的／对象／监管归属不匹配（含应列而未列、不应列而列入，例：税务定价目的报告列入国资监管法规） | 报告位置 + 本项目五轴画像 + 不匹配理由 |
+
+- 具体失效／待更新文件清单与应替换文本，按 `06-规则库/01-监管规则与口径/依据时效对照表` 的库内层级路径寻址键，经本次实时下载后只读引用（该条目 **2026-09-16 已入库**，编号 `RULE-01-03-001~030`：三类判定口径 + 逐条对照）；**本文件不复制该对照表正文**；该条目下载不到时按 §5 `G-5` 记 gap 并转人工，**不凭经验判定版本新旧**。
+- 表内标注 `核验状态=待官方核验` 的行（文号待核、标准现行版本待核），出意见前须先比对官方原文，不得直接据此判"依据过期"。
+- 本类缺陷只核"依据章节自身"，不重复核测算参数取值（归方法轴）。
+
+**方法与程序披露**：评估方法及选取理由；仅采用单一方法时须披露适用受限或操作受限的原因（`271`）；程序实施过程说明（`272`）；评估假设披露（`273`）。
+
+**结论与特别事项**：结论须文字与数字双表述、载明使用有效期，区间值或其他形式须经与委托人沟通（`274`）；**特别事项说明七类完整性判定主干**（`275`）；使用限制说明四项（`276`）；报告日（结论形成日）与签署日可不同，按字段口径核对（`277`）。
+
+**程序受限的报告说明义务**（`257`，与程序层衔接）：程序受限时报告须说明受限情况、处理方式及其对结论的影响三要素；受限对结论有重大影响或无法判断影响程度时不得出具报告。
+
+## 3. 程序与质控层检查维度
+
+### 3.1 程序执行（按 §1 选定版本的对应条目）
+
+**承接**：受理前应明确的基本事项清单（新版 `008`／旧版 `108`）；胜任能力、独立性与业务风险评价，须有书面评价记录；不具备条件仍承接为高严重度（`009`／`109`）；委托合同订立与服务费合理性（`010`／`110`）。
+
+**计划与调查**：评估计划要素齐全，计划与实际出现重大差异时是否调整（`011`／`111`）；是否实施现场调查，**抽样调查是否对方法、比例、样本代表性作出分析说明**——无分析即缺陷（`012`／`112`）；资料多维收集与涉密项目保密安排（`013`／`113`）；重要资料是否取得委托人确认，拒绝确认是否按程序缺失条款处理（`014`／`114`）；关键文件与证明的核查验证留痕（`015`／`115`）。
+
+**程序缺失与专业能力受限**（高频依据）：是否告知委托人相关限制与风险、底稿是否记录限制情形／弥补措施／影响分析、报告是否披露、有重大影响或无法判断影响程度时是否仍出具报告——后两者直接构成高严重度缺陷（`006`）；超出专业能力的受限事项处理链（`016`／`116`）。
+
+**引用其他机构报告（利用专家工作）**：报告披露引用其他机构报告结论的，**除核对披露要素（特别事项第四项，`275`）外，须单独核对报告是否说明对被引用报告本体的核查验证方式、范围与结论**（`015`／`115`）——只有披露、没有核查验证说明即出条目。被引用报告由委托人、产权持有人或其关联方出具的（如同为项目数据服务商、同一集团内机构），还须核对报告是否披露该报告的客观性保障依据；依据不足时按待人工确认处理，不直接判不符。利用专家工作类准则精编未就位时的覆盖不完整，按 §5 `G-2` 声明。
+
+**同事实多轴归属纪律**：程序层事实（引用他人报告、核实与调查程序、核查验证留痕）**不得只在报告披露轴登记**——披露轴核"是否披露"，程序轴另核"是否实施、是否与对象适配"；两轴各自出条目状态，缺一不可。事实已在披露轴出现过，不构成程序轴免检的理由。
+
+**测算与结论**：资料的分析归纳整理留痕（`017`／`117`）；方法选择是否经适用性分析（`018`／`118`）；公式与参数选取和方法的匹配性（`019`／`119`）；假设是否合理使用并已在报告中披露（`020`／`120`）；多方法并存时是否对各方法结果分析比较后形成结论（`021`／`121`）。
+
+**出具与档案**：初步评估报告编制时点与"先结论后初稿"的程序顺序（`022`／`122`）；内部审核／分级审核执行与记录（`023`／`123`）；出具前沟通保持独立判断、调整后是否再次审核（`024`／`124`，旧版无再审核要求）；重大特别事项的关注与充分披露（`025`／`125`）；业务报备与出具版本一致性（`026`）；归档及时性与完整性、涉密档案要求（`027`／`126`）。
+
+### 3.2 机构质量控制（`RULE-01-02-401~456`，2027-01-01 起施行，见 §1）
+
+**体系与责任**：质量控制体系要求与构成（`402`／`403`）；质量控制制度与程序九要素框架（`404`）；制度书面化与记录（`405`）；控制主体与责任落实机制，含独立的"项目审核人员"角色（`407`）；最高管理层界定与最终责任（`408`／`409`）；首席评估师制度与职责（`410`／`411`）；项目负责人制度——**法定评估业务项目负责人须为评估师**（`412`／`413`）；项目审核人员要求与职责四项（`414`／`415`）。
+
+**职业道德与人力**：职业道德制度与强化方式（`418`／`419`）；独立性保障（`420`）；保密管理（`421`）；人力资源配置与团队配备条件（`422`~`424`）；利用专家与外部人员工作的档案三要素——资质、独立性声明、工作底稿（`425`）；业务承接控制、客户与业务选择、承接决定、业务风险分类（`426`~`430`）；委托合同变更中止解除（`431`）；计划控制目标与制度、编制职责及新技术使用须有技术路径说明书与签批（`432`~`434`）。
+
+**实施、审核与监控**：**法定评估业务不得以估值报告或价值咨询报告替代评估报告**（`435`）；疑难问题与意见分歧须形成书面结论后方可出具报告（`438`）；项目负责人指导监督（`439`）；**内部审核与分级审核——设专门部门／岗位实施内部审核、按重要性与复杂程度分级、证券评估业务至少三级审核，二三级审核人员独立于项目团队、不得签署本人审核的报告、不得参与本人审核的项目，分支机构报告统一审核把关**（`440`，本项目"审核／复核独立性"判定最直接的规则）；报告签发与瑕疵处置（`441`）；质量监控内容、监控措施、纠正预防、体系评价改进（`442`~`445`）；文件控制——防用废止版本文件（`446`）；记录与档案管理（`447`~`450`）；质量控制记录类别含 AI／相关技术工具使用记录（`448`）；数据安全、信息技术控制、**数字化技术不得替代专业判断**、人工复核机制、网络安全（`451`~`455`）。
+
+## 4. 与其他能力的接口
+
+| 接口 | 本技能负责 | 交出给谁 |
+| --- | --- | --- |
+| 报告载明的方法与理由是否完整（`271`）↔ 方法选取是否恰当 | 载明与披露完整性 | method 轴 |
+| 程序受限的说明义务（`257`）↔ 受限处理链（`006`／`016`） | 说明义务与处理链留痕 | 对象／方法轴判断影响程度 |
+| 特别事项七类披露（`275`）↔ 重大特别事项关注（`025`） | 披露完整性 | 对应专业轴 |
+| 基准日一致性（`269`）↔ 基准要素一致性模块 | 报告与合同基准日比对 | 对象／业务轴 |
+| 报告引用数字可追溯（`015`／`019` 留痕）↔ 表格勾稽差异清单 | 底稿留痕核对 | `crwu-audit-datacheck` |
+| 分级审核与审核人员独立性（`440`） | 机构层面合规 | 人工复核（涉机构制度） |
+
+## 5. 内容缺口（如实登记，不补造）
+
+| 编号 | 缺口 | 影响 |
+| --- | --- | --- |
+| G-1 | 质控指南旧版（中评协〔2017〕46 号）**未精编**，库内仅有 2026 版（2027-01-01 起施行）精编条目 | 2026 年内报告的机构质控对照**无现行依据**，只能记 gap 并转人工 |
+| G-2 | 利用专家工作准则（中评协〔2017〕35 号）精编**待办**，库内仅有索引卡（不构成规则条目） | 专家工作类程序与披露检查只能间接引用报告准则特别事项与质控指南专家工作条款，须声明覆盖不完整 |
+| G-3 | 报告准则体系在准则重构期是否修订**处于跟踪状态** | 报告日跨重构节点的项目版本适用性需人工确认 |
+| G-4 | `报告准则-报告内容与附则` 中声明要素条目数与模板参考文件所述条目数**表述不一致**（一处为六项、一处为七项） | 声明章节核查按规则条目原文为准，条目数分歧登记为待核项，不自行取舍 |
+| ~~G-5~~ | **已消解（2026-09-16）**：`06-规则库/01-监管规则与口径/依据时效对照表` 已入库（`RULE-01-03-001~030`） | 已可按该路径键实时引用；仅 `核验状态=待官方核验` 的行仍须比对官方原文后再出意见 |
+
+`报告准则-附件格式与声明样稿-参考` 为模板类参考文件，只做格式基线对照，不构成硬依据；其使用提示要求以规则条目原文判定。
+
+## 6. 输出
+
+条目状态、证据字段、来源优先级与 gap 登记按 [执行契约](03-execution-contract.md) 对应章节执行，不在此复述。本技能特有要求：
+
+- 报告披露层与程序质控层**各自独立**出条目状态，任一层缺依据不影响另一层执行；
+- 版本选择结论（选定的版本与依据）须在输出中显式记录，便于人工复核；
+- 索引卡与模板参考类文件不得出现在 `rule_source` 的规则性缺陷依据中。