kai/writer-work-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
160 Commits 1 Branch 0 Tags
1392830e57f3ea0b9e71a3604f220e7232af37ab
Commit Graph

160 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Yaojia Wang
3d2a8b8cee feat(web): 角色关系图谱（灵感⑥缩减版/D4） 
设定库人物 tab 新增 React Flow 关系图谱，仅用现有角色读端点数据
（CharacterRelationView={name,kind,note}）：边按 name-join、kind 作中文
标签、节点按 role 上色，无 closeness/阵营（数据不存在，不硬造）。

- lib/characters/graphLayout.ts：纯逻辑（role→分组配色关键词映射 / 节点
  去空重名 / kind→标签+DEFAULT_RELATION_LABEL / 悬空边跳过并计数 / 自指
  跳过 / 互指无向去重 / @dagrejs/dagre 一次性确定性初始坐标、中心→左上、
  不可变更新）+22 单测。
- components/characters/RelationshipGraph.tsx：'use client'，经 CodexPage
  dynamic(ssr:false) 挂载；显式容器高度 + import RF CSS + prefers-reduced-
  motion 关 fitView 动画 + 纸感 CSS 变量配色 + 悬空计数提示。
- 依赖：@xyflow/react@^12.11.2 + @dagrejs/dagre@^3.0.0。

无后端契约变更/迁移/gen:api。门禁：lint/typecheck 干净、vitest 565、
coverage lib 95.4%(graphLayout 97.6%)、build OK。
 2026-07-06 17:38:58 +02:00
Yaojia Wang
7babb4854b feat(web): 角色群像按定位配比生成（role_mix 缩减版） 
- 契约: CharacterGenerateRequest 加 role_mix{定位:数量}，model_validator 归一
  count=各值之和（每项≥1、总和≤12），缺省退回单一 role+count
- @llm: build_character_gen_context/run_character_gen 加 role_mix 参并注入配比块
  （确定性、无时间戳，守 assemble 纯函数）；router 穿参
- character-gen.md 加"按配比严格分配 role"纪律 + regen prompt_hashes 金标准
- 前端: sanitizeRoleMix/roleMixTotal + buildCharacterGenerateRequest 第4参 +
  useCharacterGen 穿参 + RoleMixEditor + CharacterGenerator 单一/配比双模
 2026-07-06 17:24:16 +02:00
Yaojia Wang
72b3c81146 feat(review): 人物塑造 advisory 审（第五审，仅建议不阻断验收） 
写→审链新增第五审「人物塑造」（灵感③/D2）：advisory 单维——仅建议、不阻断
验收（不进 conflicts、不碰 assert_conflicts_resolved、不入 REVIEW_RESERVED_NAMES）；
只做人物塑造、不做氛围。

- SPEC characterization_spec（analyst，reads=("characters",)，writes=()）+
  prompts/characterization.md（只读、显式忽略文本长度与辞藻华丽度、引用逐字片段+置信度）
- schema CharacterizationReview{issues[...]}（全字段默认值守解析韧性）+ 注册 catalog
- 计数三处 22→23 + regen prompt_hashes.json（仅加一条）
- DB chapter_reviews 加 characterization JSONB nullable 列（迁移 f6a7b8c9d0e1）
- 接线：graph REVIEW_SPECS 追加 · chain ReviewRecordRepo · collect(extract/record) ·
  review_repo(Protocol/Sql/_to_view/ReviewView) · sse(event/factory/section) · normalize 自动纳入
- 契约 ReviewHistoryItem 加 characterization（gen:api 已重生成）
- 前端 sse/history/useReviewStream + CharacterizationPanel（只展示无裁决 UI、置信度降序+低置信折叠）+ ReviewReport 挂面板
- 测试 test_characterization_does_not_block_accept + 计数/golden + collect/normalize + 前端 reducer/normalize/parse

守不变量 #2/#3/#9；依赖 ⑧（motive/appearance 作客观锚点）。
 2026-07-06 17:08:38 +02:00
Yaojia Wang
2a7a865e98 feat(core): continuity 冲突裁决反哺——上一已验收章保留裁决入本章 volatile 前瞻约束 
灵感②/D3 窄版 v1：assemble 读上一已验收章的 continuity 冲突作者裁决
（decisions.items 按 conflict_index join 回 conflicts 取正文），仅保留
verdict∈{accept,manual}、去重、按 conflict_index 排序、有界 top-3，
用确定性字符串模板改写成前瞻正向约束，注入本章 volatile「上一章冲突提醒」。

- 绝不调 LLM、绝不反哺 advisory（style/pace/characterization 无作者裁决 oracle）——守不变量 #3/#4。
- 只入 volatile、永不进 stable_core 缓存前缀（依赖上一章裁决、每章易变）——守 #9。
- assemble 仍是确定性纯函数、字节稳定、可缓存——守 #6/#7。
- decisions 非空=已验收（只在验收事务写入）；未验收上一章不反哺——守风险#5。
- MemoryRepos 末位加 review: ReviewRepo | None = None（默认 None→优雅降级不反哺），
  docstring 8→9；sql_memory_repos 工厂补 review=SqlReviewRepo（既有构造点靠默认无需感知）——守风险#6。
 2026-07-06 16:38:06 +02:00
Yaojia Wang
02d19019f6 feat(web): AI 立项方案生成+预填（种子门控 + 按字段接受） 
向导阶段（project 未建）一键推演结构化书级蓝图预填立项向导。

- 新 SPEC project_plan_spec（analyst 档，纯预览 reads/writes=()）+ schema
  ProjectPlanResult（书名候选 + 时空背景/叙事结构/故事核心/结局设计/基调，
  全字段默认值守解析韧性）+ 注册 SCHEMA_CATALOG；计数三处 21→22 + regen golden。
- 端点 POST /skills/project-plan/generate（不带 project 前缀，绕开 toolbox 404）：
  请求体序列化向导草稿为 project_context，复用 build_brief_context + run_generator；
  种子门控（缺 genre/logline→422）；请求 schema 加 max_length 上界。
- run_generator/_build_request 的 project_id 放宽 uuid.UUID|None（向导无 project）。
- 前端 wizard.ts 加 mapPlanResultToWizardForm（错配字段折进 premise 不静默丢）+
  applyPlanPatch（仅回填空字段、保护已编辑）+ useProjectPlan hook + PlanAssistant。
 2026-07-06 16:26:08 +02:00
Yaojia Wang
821ace5989 feat(web): 立项新增 基调/结局/视角 三字段（书级常量入 stable_core 缓存前缀） 
灵感计划 §3④ + §4 D 枚举决策：
- projects 表加 tone/ending_type/narrative_pov（Text nullable、无 CHECK，同 genre/structure；
  迁移 e5f6a7b8c9d0 nullable 免 backfill）。
- ProjectCreateRequest/ProjectResponse + domain ProjectCreate/ProjectView 全链路透传（snake_case）。
- 完整 stable_core 链路：ProjectSpecView + SqlProjectSpecRepo.spec + _build_spec_section 渲染进
  「作品蓝本」块——书级常量随书稳定，字节稳定守缓存前缀不变量 #9，绝不入 volatile。
- 前端 wizard.ts 三字段 + 预设数组 TONES/ENDING_TYPES/NARRATIVE_POVS + ProjectWizard 控件与确认页回显。
- 契约变更已 pnpm gen:api + memory/contracts.md 登记。
 2026-07-06 15:59:49 +02:00
Yaojia Wang
491d9342ef merge: appearance/motive 全栈穿线 (P1 流B) 2026-07-06 14:38:17 +02:00
Yaojia Wang
acde715515 feat(character): appearance/motive 全栈穿线 + motive/traits 口径重切 
打通 appearance/motive 从生成→schema→契约→落库→前端整条穿线
（DB 列早在初始迁移、此前一直 NULL，无新迁移），并原子重切人物
内驱口径。

- @llm: CharacterCard/character-gen.md 加 appearance/motive（给默认值守
  解析韧性），重切——动机唯一落 motive、traits 只留核心/表层/阴影三层、
  arc 引用 motive；regen prompt_hashes.json 金标准。
- @backend: CharacterCardView + CharacterWriteRepo/SqlCharacterWriteRepo
  （create + update backfill 分支）+ CharacterWriteFields + 路由双向形变
  与 _existing_characters 带上两字段。
- @frontend: pnpm gen:api 重生成 TS 客户端；CharacterCardItem 展示/编辑
  两字段。
- 测试: schema 默认值/解析、动机不双写重切回归、card_to_view 双向、
  ingest 透传、list 暴露、SqlCharacterWriteRepo create/backfill 真 pg 集成。
 2026-07-06 14:36:11 +02:00
Yaojia Wang
452bd56d95 feat(agents,core,config): 写章 craft 教条块 + genre-aware 片段 + 开篇黄金三章特判 
- 新增 write_craft.md 品类无关写章 craft 内核（网文语域/show-don't-tell/对话 voice/
  反注水/结构性文字质感，灵活原则非穷举清单）+ load_craft_doctrine()（import 期读盘，
  不入 SPECS/金标准）
- build_write_request 把 craft 教条作为最前的 cache=True system 块注入（craft→stable_core，
  守缓存前缀 #9，tier=writer 不写 model）
- 新增 packages/config GENRE_CRAFT 题材片段表，assemble 按 project.genre 注入 stable_core；
  ProjectSpecView + SqlProjectSpecRepo 透传 genre
- 开篇前 3 章在 volatile 注入黄金三章提示（含章号→每章易变，不进缓存前缀）
- 修正 toolbox_registry 注释：11 条 → 15 条（legacy 3 + 新 8 + Scope B 4）
 2026-07-06 14:29:43 +02:00
Yaojia Wang
6854dac98f feat(web): 命令面板 combobox+可见入口 + sticky 导航壳 + 焦点环统一 + 抽屉锁滚动/关闭按钮 + 主题首帧修复 + 设置徽标/datalist 2026-06-30 08:56:23 +02:00
Yaojia Wang
164e98887e fix(web): 链相位语义色/失败可重试 + 模板填入中文标签/删除可撤销/工具卡文案 + 模板库 PageHeader 2026-06-30 08:56:23 +02:00
Yaojia Wang
6bb3559e25 fix(web): 规则删除按操作隔离 busy(deletingId/adding) + 全空规则页折叠为单一引导 2026-06-30 08:56:23 +02:00
Yaojia Wang
9d67f237a2 feat(web): 生成器 ThinkingIndicator/空结果态/数量校验 + 文风页 PageHeader + Codex 分段控件 + RefineView role 修正 2026-06-30 08:56:23 +02:00
Yaojia Wang
68606b84dc fix(web): 大纲生成只替换目标卷+重排确认+窗口徽标用lucide + 伏笔看板中文化/单一登记入口/Field表单 2026-06-30 08:56:23 +02:00
Yaojia Wang
f0f925b195 fix(web): 审稿面板去重标题/去英文 slug + 伏笔待登记数实时递减 + 移动端决策栏 + 对比度修复 2026-06-30 08:56:23 +02:00
Yaojia Wang
69030eacc3 fix(web): 写作台流式/保存 live region + 图标按钮换 lucide 无障碍 + 三栏改 xl 断点 + 手稿字号统一 2026-06-30 08:56:23 +02:00
Yaojia Wang
e82aff7067 feat(web): 立项向导确认步/故事结构分段控件/书名必填提示 + 作品卡键盘焦点可见 + 作品库分段切换 2026-06-30 08:56:22 +02:00
Yaojia Wang
a22a16c9c4 feat(web): 前端共享基础(focusRing/proseBody/text-2xs + useBodyScrollLock + Toast撤销 + error/not-found/loading路由边界) 2026-06-30 08:35:52 +02:00
Yaojia Wang
69f3c2a29b fix(web): 技能页 bg-paper/删除虚构创作中徽标/设置页 try-finally/文风页移动端定高 grid 2026-06-29 16:52:43 +02:00
Yaojia Wang
d7fcb8a329 refactor(web): 采用 Button/Card 原语替换多处手搓样式 2026-06-29 16:52:43 +02:00
Yaojia Wang
47eb42f274 fix(web): 后端不可用统一用 BackendDownNotice 替代 404/手搓提示 2026-06-29 16:52:43 +02:00
Yaojia Wang
f8cabc92e6 feat(web): 世界观预览补「仅预览」说明与按卡复制 2026-06-29 16:52:43 +02:00
Yaojia Wang
ffe9132f7d fix(web): 大纲错误透传 FriendlyError, 不再向用户暴露内部 code 2026-06-29 16:52:43 +02:00
Yaojia Wang
4afbbe0fe7 fix(web): 注入面板保存失败不再清空已加载实体并支持重试 2026-06-29 16:52:43 +02:00
Yaojia Wang
ab3f9e17b1 fix(web): 审稿页支持切换章节并打通验收后审下一章 2026-06-29 16:52:43 +02:00
Yaojia Wang
a2849bf6b7 feat(web): Field 标签自动关联控件 + 全局壳无障碍(skip link/设置可访问名/抽屉焦点归还) 2026-06-29 16:52:43 +02:00
Yaojia Wang
dd80b6815d fix: address ui review follow-ups 2026-06-29 12:06:04 +02:00
Yaojia Wang
90a66437d7 feat: improve app ui and project metadata 2026-06-28 07:31:20 +02:00
Yaojia Wang
3bd464d400 docs: 登记 QA-CR 全项目 code review 整改批（21 项任务表） 2026-06-27 06:35:55 +02:00
Yaojia Wang
a6f5d085e5 test: 接入 jsdom 测试栈, 把 15 个 React hooks 纳入 80% 覆盖率门禁 
新增 jsdom + @testing-library/react, 为 lib/** 全部 use*.ts hooks 写 renderHook 单测:
生成/CRUD(world/character/generator/outline/accept/foreshadow/rules)、
SSE流(draftStream/reviewStream)、定时轮询(autosave/jobPoll/kimiOauth)、
文风与注入(refine/styleLearn/injection)。覆盖率 mock api 客户端+Toast, 不打真实 LLM。
vitest.config.ts 去掉 use*.ts 排除; 前端覆盖率 63%→95%。CLAUDE.md 同步说明。
 2026-06-27 06:21:42 +02:00
Yaojia Wang
a02c6b6e4f test: 接入覆盖率工具并在 CI 强制 ≥80% 门禁 
后端: 加 pytest-cov + [tool.coverage] 配置, pytest --cov-fail-under=80 (基线~88%)。
前端: 加 @vitest/coverage-v8, vitest.config.ts 设 80% 阈值, 新增 test:coverage 脚本 (基线~93%)。
前端覆盖范围限定 lib/** 纯逻辑层; hooks(use*.ts)待 jsdom 测试栈接入后纳入。
CI backend/frontend job 改跑覆盖率门禁命令。CLAUDE.md 同步 DoD 与 Toolchain。
 2026-06-26 21:11:57 +02:00
Yaojia Wang
e9477d84d8 docs: 增加每次编码的硬门禁(Definition of Done)与提交纪律 
明确 TDD/≥80%覆盖/三类自动化测试必跑/全门禁绿/合规/每次commit/禁署名尾注；
如实标注覆盖率工具尚未接入并列出补齐待办。
 2026-06-26 21:03:35 +02:00
Yaojia Wang
01257b8952 merge: 实施 4 组设计型 QA 项（规则删除/codex 角色/大纲卷过滤/文风回炉锚点） 2026-06-25 12:53:03 +02:00
Yaojia Wang
bf39f50b2f fix(qa): 实施 4 组设计型 QA 项——规则删除/codex 角色/大纲卷过滤/文风回炉锚点 
#5 规则 DELETE + id：暴露 RuleView.id（PK）；新增 DELETE /projects/{id}/rules/{rule_id}
  （项目/规则不存在→404，成功→204，按 (id,project_id) 限定）；rule_repo 加
  list_for_project/delete；RulesPage 每条加删除（乐观删+回滚+toast）。assemble 侧
  RuleView（缓存前缀）不动，列表另立 RuleListItemView。
#7 codex 角色 relations：写侧本已持久化、读端点 _existing_characters 硬编码 []。
  加 _relations_from_jsonb 解析 {name,kind,note}，CodexPage 渲染关系 chip。
#8 角色入库幂等：SqlCharacterWriteRepo.create 改 (project_id,name) app 层 upsert——
  重复入库改更新而非插入；不加 UNIQUE/迁移（线上已有重复行会让约束迁移失败）。
#1 大纲卷过滤：GET /outline 支持可选 ?volume（无参=全部，向后兼容）；OutlineEditor
  加「查看：全部/卷N」筛选，与生成目标卷解耦。
H3/#9 文风回炉锚点：StyleDriftSegment 加 text（逐字命中段），style.md 指示审稿输出；
  前端按内容锚点定位回炉目标（idx 仅排序），命中失败 → 提示「无法定位该段」而非
  静默 no-op。style golden fixture 已重生成。

契约变更已 pnpm gen:api（RuleView.id / DELETE rules / outline ?volume）。无迁移
（alembic 无漂移）。门禁绿：ruff/mypy(210)/alembic/pytest 760 · 前端 tsc/lint/vitest 329。
 2026-06-25 12:53:03 +02:00
Yaojia Wang
e60eff7aa1 merge: 前端错误文案 friendlyFromApiError（QA #2/#11，去通用 toast） 2026-06-24 18:01:15 +02:00
Yaojia Wang
9a623688e8 fix(qa): 前端错误文案——按 API 信封 surface 真实错因，去掉通用 toast 
新增 friendlyFromApiError(apiError)：兼容业务信封 {error:{code,message}}（ARCH §7.1）
与 FastAPI 422 {detail:[...]}，422 映射为友好 VALIDATION 文案（不泄露技术细节）。
接入三处此前吞掉错因、永显通用文案的调用点：
- useOutline（QA #2）：原 env.error.code 漏读 422 detail，永显「大纲生成失败」。
- ChainPage / ChainAdjudication（QA #11）：原 friendlyError(undefined) 永显通用 toast，
  现 surface 真实 code（如 LLM_UNAVAILABLE→去设置 provider / CONFLICT→提示裁决）。
+ messages.test.ts 加 3 例（业务码带动作 / 422→VALIDATION / 未知形兜底）。
门禁绿：vitest / tsc / eslint 干净。
 2026-06-24 18:01:15 +02:00
Yaojia Wang
f4f01aeca9 merge: 修 3 个 QA MEDIUM（规则 GET 404 / 空白 content 422 / 未知 tier 422） 2026-06-24 17:51:03 +02:00
Yaojia Wang
3868f80502 fix(qa): 修 3 个 QA MEDIUM——规则/档位路由校验收紧 
- 规则 GET 不存在 project → 404（原返误导性空 200，掩盖坏 id）：list_rules 加
  项目存在校验（仿 C1/H2）。
- 规则 content 纯空白 → 422（原 strip 前校验 min_length，空白行入库成垃圾）：
  改 StringConstraints(strip_whitespace=True, min_length=1)。
- 档位路由 tier 限定 writer/analyst/light（Tier Literal）→ 未知档位 422
  （原接受任意字符串）。

回归测试：test_generation（GET rules 404）/ test_rules（空白 content 422）/
test_settings_providers（未知 tier 422）。门禁绿：ruff/format/mypy(210)/pytest。
 2026-06-24 17:51:02 +02:00
Yaojia Wang
7a40c7fbb5 merge: 修 QA C1/H1/H2（写章/规则项目校验 404 + 立项向导字段覆盖） 2026-06-24 17:17:35 +02:00
Yaojia Wang
2fe3bedfba fix(qa): 修 QA C1/H1/H2——写章/规则缺项目校验 + 立项向导字段覆盖 
C1 (CRITICAL) stream_draft：对不存在 project 流式写章先 fail-fast 404，
  否则非法 id 静默烧一次付费/限流 LLM 调用并返 200。在触网关前查 project_repo.get。
H2 (HIGH) create_rule：给不存在 project 加规则原 FK 违例逃逸成 500 → 改为入库前
  校验项目存在返 404（仿 chain/_require_project）。
H1 (HIGH) ProjectWizard：第3步「立意」与第4步「主角/金手指」原共用 form.premise
  互相覆盖丢数据 → 新增独立 form.protagonist，toCreateRequest 合并两段进 premise
  （M1 projects 表仍只有 premise，不编造 API）。

回归测试：
- test_projects.py：stream_draft 不存在 project → 404 且网关零调用；已有 draft
  用例改 seed 真项目。
- test_rules.py：create_rule 不存在 project → 404 不写库；已有用例 seed 真项目。
- wizard.test.ts：premise+protagonist 合并不互相覆盖（2 例）。
门禁绿：ruff/format clean · mypy 210 · pytest 749 · 前端 tsc/lint/vitest 干净。
 2026-06-24 17:17:35 +02:00
Yaojia Wang
a4ef250fc9 fix(review): 验收冲突显示与闸门对齐 — 验收报 CONFLICT_UNRESOLVED 时回拉最新审稿并回灌冲突；未审稿不再误显「可直接验收」 2026-06-24 16:17:54 +02:00
Yaojia Wang
d0c301349c merge: fix 多章链 checkpointer 连接串剥离驱动后缀（ProgrammingError 修复 + 回归测试） 2026-06-24 13:03:58 +02:00
Yaojia Wang
b5002a9864 fix(chain): checkpointer 连接串剥离 SQLAlchemy 驱动后缀 
多章链 job 一发起即 failed（exc_type=ProgrammingError）。根因：runtime
checkpointer 工厂把 settings 的 sync URL `postgresql+psycopg://…` 原样喂给
`AsyncPostgresSaver.from_conn_string`，psycopg 不识别 `+psycopg` 方言段 →
`ProgrammingError: missing "=" …`，链在打开 saver 时即崩。

E2E 用 MemorySaver 覆盖 get_checkpointer_factory，从不走真 conn string，故此
路径无回归保护、bug 未被测出（迁移 d3e4f5a6b7c8 里 `_psycopg_conn_string` 已
正确剥离，runtime 缝漏了同款处理）。

修复：chain_deps 加 `_libpq_conn_string()`，剥离 `+psycopg`/`+asyncpg` 还原为
标准 libpq 串后再交 from_conn_string。+ 单测 test_chain_deps.py（3 参数化用例）。
已直连真 pg 复验：saver.aget OK，ProgrammingError 消除。
 2026-06-24 12:40:40 +02:00
Yaojia Wang
9d94957a9b merge: 方案A 协同回写（contracts/decisions/gotchas/PROGRESS/ARCH）+ structlog 依赖补声明 2026-06-24 08:25:26 +02:00
Yaojia Wang
0021426f09 docs(prompt-mgmt): 方案A 协同回写 + 补声明 structlog 依赖 
- memory/contracts.md：立 C6-ext（load_prompt/SPECS/SCHEMA_CATALOG/
  REVIEW_RESERVED_NAMES/SpecResolver + 打包契约）+ 变更日志一笔
- memory/decisions.md：方案A 决策（运行时值金标准/尾换行方案B/守卫前移/
  schema 留 Python/同一实例）
- memory/gotchas.md：spec.name 连字符命名 / 改稿须重生成金标准 /
  .gitattributes 完整嵌套路径 / wheel artifacts 带 .md / structlog 补声明 /
  SpecResolver 零 DB + 精确匹配
- PROGRESS.md：已封板「Prompt 管理重构 + 全量重写」波次
- ARCHITECTURE.md §5.1：补 prompt 外置 + SPECS/SCHEMA_CATALOG/SpecResolver，
  内置 agent 计数 8→21
- packages/{llm_gateway,core}/pyproject.toml：补声明 structlog>=24.1
  （原直接 import 未声明，靠 apps/api 传递；裸装 import ww_agents 会缺）
 2026-06-24 08:25:26 +02:00
Yaojia Wang
eb356c42a9 merge: 全量重写 21 个 prompt——任务对齐 + prompt 工程最佳实践（交叉验证，门禁全绿） 2026-06-24 05:17:15 +02:00
Yaojia Wang
aac8b31b9f refactor(agents): 全量重写 21 个 prompt——任务对齐 + prompt 工程最佳实践 
对全部外置 prompt 做激进重写（每条经独立 agent 网络调研 + 重写，再由
另一 agent 交叉验证），让每条更贴合其 agent 任务。纯内容优化，零结构/schema
变更；金标准 fixture 同步重生成。

- 四审（continuity/foreshadow/style/pace）：保持只读，强化判定方法——
  continuity 证据对子 + 假阳性纪律；pace 0-5 爽点锚点；style 0-100 评分锚点
  + 字数 100 短段豁免/无指纹降级；foreshadow 埋设—回收契约
- 生成器：角色框定 + 落笔前自检 + 示例 + 差异化反雷同（character-gen/opening
  黄金三章/blurb/worldbuilder 硬规则/golden-finger/glossary/name/book-title/brainstorm）
- writer：去 AI 腔/机翻腔检查表 + 不改情节/事实约束（refiner 仍纯文本无 JSON、
  continue 无缝承接、expand、de-ai）
- 结构类：outliner 逐章蓝图 / fine-outline 分场节拍 / style_extract 先取证后下判 /
  teardown 粗拆→细拆

护栏全验：output_schema 契约逐字段保留、无具体 model 名、无占位/format 槽、
中文、≤1 尾 LF、无 BOM。语义锚点（差异化/100/硬规则）保留，3 个措辞耦合用例
无需改即过。门禁绿：ruff/format clean · mypy 209 · pytest 744 passed
（金标准 #5 对齐重生成 fixture；内容无关的 #2/#12 仍绿）。
 2026-06-24 05:17:15 +02:00
Yaojia Wang
4f561dad35 merge: prompt 外置方案A — 21 prompt → .md + SpecResolver（TDD + 交叉评审，门禁全绿） 2026-06-24 04:52:59 +02:00
Yaojia Wang
dca4d45d4e refactor(agents): prompt 外置方案A — 21 prompt 散文外迁 .md + SpecResolver 
把 21 个内置 agent 的 system_prompt 从 specs.py 的 Python 常量外置为
prompts/<spec.name>.md，import 期由 load_prompt 确定性加载；建立 SPECS 名册
+ SCHEMA_CATALOG（Pydantic 类型留 Python）+ 统一只读解析入口 SpecResolver。
纯重构、零功能/schema 变更，缓存断点前块字节级不变（不变量 #9）。

@llm packages/agents（步骤1-3）
- spec_model.py：抽出 AgentSpec（frozen，字段不变）
- prompt_loader.py：load_prompt = utf-8-sig 去BOM → LF 归一 → NFC → rstrip尾LF，
  内存缓存 + fail-fast（PromptNotFoundError），import 期确定性
- schema_catalog.py：SCHEMA_CATALOG[name]→output type 唯一真相源（refiner=None）
- prompts/*.md ×21：取常量「运行时值」程序化外迁（反斜杠折行已塌缩，
  物理换行≡运行时换行）；文件名按 spec.name 连字符（style.md/character-gen.md 等）
- specs.py：删 21 常量 + AgentSpec 类；system_prompt=load_prompt(name)、
  output_schema=SCHEMA_CATALOG[name]；建 SPECS + REVIEW_RESERVED_NAMES；
  *_spec 兼容期保留且 SPECS[name] is *_spec（同一实例）。804→337 行
- __init__.py：显式 __all__ 重导出（避 F401）

@backend packages/skills（步骤4-5）
- SpecResolver：内置 SPECS（纯内存、零 DB）+ 用户 SkillRegistry 统一 get；
  内置 name 永不触发 DB；output_schema_for 精确匹配
- skill_registry：保留命名空间守卫前移至入库校验，拒同名内置 → VALIDATION
- toolbox_registry：GeneratorTool.spec 改走 SPECS[...]，删 12 个 *_spec 直接 import

@devops repo-root
- .gitattributes：prompts/*.md text eol=lf（修正：须用完整嵌套路径才匹配）
- packages/agents/pyproject：hatchling artifacts 纳入 prompts/*.md 随 wheel/sdist 分发
- ci.yml：新增 build wheel → 裸装 → import ww_agents.SPECS 冒烟

TDD 全程 mock 网关；门禁绿：ruff/format clean · mypy 209 files · pytest 744 passed
（含金标准 sha256 回归 / md↔spec↔catalog 一一对应 / fail-fast / BOM+NFC /
内置守卫 / 同一实例 / 编排器无回归 / apps/api import-smoke / 打包冒烟）
 2026-06-24 04:49:44 +02:00
Yaojia Wang
f9ff89cd6b merge: 续补三件 — 拆书入库rules / 续写式链 continue_volume / 模板库 
多 agent 逐学科建造 + 4 路对抗交叉评审 + 修 3 HIGH。
后端 mypy 202 / alembic 无漂移 / pytest 670；前端 vitest 309/build 绿。
 2026-06-23 20:45:56 +02:00