writer-work-flow

kai/writer-work-flow

Fork 0

Commit Graph

Author	SHA1	Message	Date
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	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	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

Author

SHA1

Message

Date

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

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

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

3 Commits