muse-agent-example/tests/skills/assemble-context/test_fine_outline_reader.py
zizi c9f69d9d6d 治理: Skill 测试治理第一阶段——harness 控制平面 + 实现测试迁出运行时目录
范围(不含 design-story-foundation、docs/、humanization/README.md 等进行中改动):

1. 新增 harness/ 控制平面
   - skill_harness.py 静态审计:32 个运行时 Skill 的 frontmatter/manifest/文档污染,当前 0 问题
   - run_selected.py 选择性执行器:manifest 与磁盘一一对账、依赖阻断、
     空跑与 skip-only 失败关闭、AST 测试形状门
   - manifests/skills.json:32 个 Skill 的合同责任方与协作领域登记
   - manifests/test-inventory.json:81 个测试资产登记
   - specs/skill-testing.md 与 README.md:测试分层、证据边界与 harness 职责

2. 实现测试从 .claude/skills/*/scripts/ 迁至 tests/skills/<skill>/
   - 71 个测试文件迁移并修复项目根与临时目录运行导入
   - 数据库触发器测试宽泛异常收窄为 psycopg.errors.RaiseException
   - 抽取离线大测试拆出真实 PG smoke(默认阻断,不计入离线通过)
   - 抽取 presence 去重边界拆出独立测试:493 + 78 = 571 项检查不变

3. 运行时文档清理
   - 13 个 SKILL.md 移除自测/离线验证段落、测试命令与测试文件事实源表述,
     只保留运行时合同;业务运行合同、额度、授权与离线模式均保留

4. SoT 同步
   - AGENTS.md:新增 Skill 领域索引(7 个合同责任方分组,覆盖 32 个运行时 Skill)
   - 领域 07:测试入口改由 harness/manifests/ 登记,SKILL.md 不承载测试命令
   - humanization 覆盖矩阵:活动测试路径同步迁移

验证证据: harness 自测 15 项 + runner 自测 13 项通过;静态审计 32 Skill / 0 问题;
73 个非数据库测试通过;8 个集成条目中 6 个 PostgreSQL 项被依赖门明确阻断;
py_compile 与 git diff --check 通过。未连接 PostgreSQL、网络、真实模型或额度。

已知边界: 真正 skill_behavior_eval 仍为 0,尚未验证任何 Skill 自然语言行为;
evaluate-frozen-replay 的 raw 存储边界冲突留待单独治理。
2026-08-19 01:50:20 +08:00

69 lines
2.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env python3
"""细纲库读统一消费点回归:load_confirmed_fine_outline 的取数合同(不连真库,用桩连接)。"""
import pathlib
import sys
import unittest
PROJECT_ROOT = pathlib.Path(__file__).resolve().parents[3]
SCRIPT_DIR = PROJECT_ROOT / ".claude" / "skills" / "assemble-context" / "scripts"
sys.path.insert(0, str(SCRIPT_DIR))
from retrieve_writer_sources import RetrievalError, load_confirmed_fine_outline # noqa: E402
class FakeCursor:
def __init__(self, row):
self._row = row
def fetchone(self):
return self._row
class FakeConn:
"""记录 SQL 与参数,按预设行返回,模拟 db skill 连接的 execute/fetchone 接口。"""
def __init__(self, row):
self._row = row
self.sql = None
self.params = None
def execute(self, sql, params=None):
self.sql = sql
self.params = params
return FakeCursor(self._row)
class FineOutlineReaderTest(unittest.TestCase):
def test_returns_dict_payload_and_uses_confirmed_latest_contract(self):
conn = FakeConn(({"targetChapter": 3, "chapterGoal": "x"},))
result = load_confirmed_fine_outline(conn, work_id=12, target_chapter=3)
self.assertEqual(result["targetChapter"], 3)
# 取数合同:fine_outline + confirmed + 未删 + version 倒序取最新。
self.assertIn("section_type='fine_outline'", conn.sql)
self.assertIn("state='confirmed'", conn.sql)
self.assertIn("deleted=false", conn.sql)
self.assertIn("ORDER BY version DESC LIMIT 1", conn.sql)
self.assertEqual(conn.params, (12, 3))
def test_parses_jsonb_returned_as_string(self):
conn = FakeConn(('{"targetChapter": 5, "chapterGoal": "y"}',))
result = load_confirmed_fine_outline(conn, work_id=12, target_chapter=5)
self.assertEqual(result, {"targetChapter": 5, "chapterGoal": "y"})
def test_missing_confirmed_outline_fails_closed(self):
conn = FakeConn(None)
with self.assertRaises(RetrievalError) as ctx:
load_confirmed_fine_outline(conn, work_id=12, target_chapter=9)
self.assertIn("已确认细纲", str(ctx.exception))
def test_illegal_payload_fails_closed(self):
for bad in (None, "{}", "[]", '"str"'):
conn = FakeConn((bad,))
with self.assertRaises(RetrievalError):
load_confirmed_fine_outline(conn, work_id=12, target_chapter=3)
if __name__ == "__main__":
unittest.main()