knowledge-vault/discussions/technology/Codex/1.重构CCPE/写作相关智能体/检查张辽.md

208 lines
12 KiB
Markdown
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.

# 1
我在writing-workbench中用子会话调用张辽了三次。
`C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体\audit\张辽\`
* `r1.1`是第一次会话的第一次调用;
* `r1.2`是第1次会话的第2次调用
* `r2.1`是第2次会话的第1次调用.
现在的问题是,除了`r1.1`像张辽,其他两次都不像。每个目录下的`prompt-to-send.md`是发出的;`returned-output.md`是回复。
* `C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体\audit\张辽\r1.1\prompt-to-send.md`
* `C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体\audit\张辽\r1.1\returned-output.md`
不像的原因:
1. 标题不对
2. 内容结构不对
3. 口吻不对
我看了张辽的原始提示词WEB 单智能体),位置`C:\Users\wangq\Documents\Codex\knowledge-vault\prompts\ccpe\ccpe\强哥的虎贲卫\张辽\张辽1.2.md`和CCPE System中的`C:\Users\wangq\Documents\Codex\ccpe-system\agents\lite\zhang-liao.prompt.md`,也确实是对原题诗词的封装,那么为什么后两次完全不像呢?
对,明白了。更准确的复盘是:
`水晶裹尸布与生命体提纲评审-张辽.md` 现在不是第一次调用时的原始 prompt而是“原始 prompt + 你后来手动贴入的 r1.1 张辽回复”。所以我刚才用当前文件尾部去解释 r1.1,确实把后置状态误当成了前置输入。
真正可用的证据是子线程记录:第一次子线程在执行中主动发现“只写了 CCPE 张辽,但任务文件没定义张辽标准”,于是它自己去找并加载了本地 canonical 张辽提示词,所以像张辽。后两次没有把这个“主动找 canonical prompt”的行为固化进委派协议因此漂成了普通 review 输出。
核心修正不变:以后 invocation packet / prompt-to-send 里必须显式带 `canonical_artifact_path`,并要求先读取张辽 Lite读不到就阻塞。这样就不依赖子线程临场自救。
# 2
> 后两次没有把这个“主动找 canonical prompt”的行为固化进委派协议因此漂成了普通 review 输出。
这个是谁没有固化?
是你这里要改,还是`writing-workbench`
你可以对比检查一下巨人的配置。
巨人的三次输出很稳定,`C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体\audit\巨人`,一看就是巨人的东西。
所以巨人的配置应该没问题。
不是 `zhang-liao.prompt.md` 本身没固化。没固化的是 **writing-workbench 的委派包/调用记录层**
我对比了巨人:
- 巨人三次 `prompt-to-send.md` 和张辽是同一类模板,只把名字换成 `巨人`
- 巨人的 `run-metadata.json` 也没有 `canonical_artifact_path`、`canonical_agent_artifact_path`、`giant-cognition.prompt.md`。
- 巨人稳定,是因为巨人子线程在执行时也主动发现“任务文件没有 persona spec”然后自己去 `ccpe-system` 找到了 canonical Giant prompt并用了 `# 巨人认知分析报告`、`GL0-GL4` 结构。
- 张辽第一次也自救成功;后两次没有稳定自救,于是漂成普通 review。
所以结论是:**巨人的输出稳定,但巨人的配置并不比张辽完整。它是运行时自救更稳定,不是委派协议更正确。**
职责拆分应是:
`ccpe-system` 负责提供 canonical agent/prompt 和 invocation contract 标准。这里其实已经有规则Agent Invocation Packet 要包含 `canonical_artifact_path`、`role_integrity_requirement`、`no_simulation_requirement``prompt-to-send.md` 必须包含 canonical prompt/spec 或 canonical path。
`writing-workbench` 负责把这个标准落到具体项目调用里。当前 `writing-workbench/docs/invocation-policy.md` 只要求 `run-metadata.json`、`prompt-to-send.md`、`returned-output.md`,但没有要求记录和强制加载 canonical reviewer artifact。这就是这次漏掉的地方。
要修,优先改 `writing-workbench` 的委派模板/运行规则:
```yaml
reviewer_id: 张辽
canonical_artifact_path: C:\Users\wangq\Documents\Codex\ccpe-system\agents\lite\zhang-liao.prompt.md
canonical_artifact_type: ccpe_lite_prompt
invocation_mode: prompt_path_reference
role_integrity_requirement: must_read_before_task
missing_artifact_behavior: blocked_missing_canonical_prompt
output_structure_authority: canonical_artifact
wrapper_authority: metadata_and_file_contract_only
```
同时在 `prompt-to-send.md` 里加硬规则:先读取 canonical prompt读不到就阻塞YAML/输出路径只是外层文件契约,不得覆盖张辽原始标题、结构和口吻。
如果要制度化,可以在 `ccpe-system` 里再补一份更硬的 reviewer invocation template但这次故障的实际落点在 `writing-workbench` 的调用包生成。
# 3
你再查一下显影的,也是三次,`C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体\audit\认知显影`。
尽管有了显影报告的标题,但是味道不太对。
要么是你修了显影变成真的lite版我不适应要么是没调用对。
结论:**不是你不适应新版 Lite主要是没调用对。**
认知显影确实已经被修成了正式生产 Lite`C:\Users\wangq\Documents\Codex\ccpe-system\agents\lite\cognitive-imaging-practitioner.prompt.md`。这个版本要求很明确五步显影流程、RAW/底片、暗房、放大、曝光、显影、先忠实显影再结构压力测试,默认输出应接近:
`# 《{主题}》认知显影报告`
`第一部分:总体评估`
`第二部分:过程分析`,包含 RAW / 暗房 / 放大 / 曝光 / 显影
`第三部分:结构压力测试`
`第四部分:结论与后续步骤`
但这三次实际输出不是这个结构。
我查到的调用链是:
- `prompt-to-send.md` 三轮都只写了“CCPE「认知显影」”没有 `canonical_artifact_path`,也没有 `agents/lite/cognitive-imaging-practitioner.prompt.md`
- `run-metadata.json` 三轮也没有 canonical prompt 记录。
- `提纲评审-显影.md``提纲评审R2.md` 本身没有内嵌认知显影 Lite 的角色定义,也没有五步显影流程。
- r1.1 子线程没有像巨人/张辽第一次那样主动去找 canonical prompt而是直接写了一个项目根目录 `returned-output.md`,后来被 controller 移到 audit 目录。
- r1.2 是延续 r1.1 的错误基线。
- r2.1 新线程也没有加载 canonical 显影 Lite而是按普通 file-first review 做了“认知结构评审”。
所以显影这三次的状态是:**标题和少量术语像显影,但内核没有跑显影 Lite。** 更准确地说,是“普通审稿 + 认知显影名义”,不是正式认知显影。
和巨人不同的是:巨人子线程自己发现缺 persona spec然后主动加载了 `giant-cognition.prompt.md`;认知显影没有自救。张辽第一次自救成功,后两次没稳定成功。根因仍然是 `writing-workbench` 调用包没有强制 canonical artifact。
修复应在 `writing-workbench` 的 reviewer invocation 包里做:
```yaml
reviewer_id: 认知显影
canonical_artifact_path: C:\Users\wangq\Documents\Codex\ccpe-system\agents\lite\cognitive-imaging-practitioner.prompt.md
canonical_artifact_type: ccpe_lite_prompt
role_integrity_requirement: must_read_before_task
missing_artifact_behavior: blocked_missing_canonical_prompt
output_structure_authority: canonical_artifact
wrapper_authority: metadata_and_file_contract_only
```
并且 `prompt-to-send.md` 要明确:先读取 canonical prompt读不到就阻塞项目 YAML 和输出路径只能作为外层文件契约,不能替代显影报告结构。
# 4
我前面对`writing-workbench`做了重构,你可以认为就是个初始化,是个空项目。
我是这么对它说的:
```md
是你的本次工作路径:
`C:\Users\wangq\Documents\Codex\writing-workbench\projects\水晶裹尸布与生命体`
我需要你先检查环境是否能用子线程独立调用CCPE的张辽、认知显影和巨人。
如果环境无误需要分别调用在Thread中调用这三个智能体提示词则使用
* 张辽用:`C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\article-discussions\AI开发方法论-价值方舟建造蓝图\9.水晶裹尸布与生命体\水晶裹尸布与生命体提纲评审-张辽.md`
* 巨人用:`C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\article-discussions\AI开发方法论-价值方舟建造蓝图\9.水晶裹尸布与生命体\水晶裹尸布与生命体提纲评审-巨人.md`
* 显影用:`C:\Users\wangq\Documents\Codex\knowledge-vault\discussions\article-discussions\AI开发方法论-价值方舟建造蓝图\9.水晶裹尸布与生命体\水晶裹尸布与生命体提纲评审-显影.md`
有问题提出。
```
它的回复:
```md
环境无阻塞,已启动 3 个独立背景 Thread
- 张辽:`019ee223-4c21-7d40-9a94-12ce54bb283d`
- 巨人:`019ee223-6914-7193-b29b-e0ba5772100c`
- 认知显影:`019ee223-812a-7182-87ae-94d2c7de6891`
已确认:工作路径存在,三份提示词文件均存在且可读,`writing-workbench` 可作为本地项目创建背景线程。三个线程当前都是 `inProgress`。唯一注意点:`projects\水晶裹尸布与生命体` 目录目前为空;这不影响调用,但后续如果需要沉淀记录文件,需要再落地。
::created-thread{threadId="019ee223-4c21-7d40-9a94-12ce54bb283d"}
::created-thread{threadId="019ee223-6914-7193-b29b-e0ba5772100c"}
::created-thread{threadId="019ee223-812a-7182-87ae-94d2c7de6891"}
```
---
那么它到CCPE-System里应该读什么或者需要它项目里放个什么/先写个什么?
以保证它以后都能做对,而不是每次我到你这儿来查错,然后让它去改,对吧
已经在 CCPE 里准备好了一个通用接入供应件:
[ccpe-agent-consumer-setup.md](C:/Users/wangq/Documents/Codex/ccpe-system/runtimes/hybrid/ccpe-agent-consumer-setup.md:1)
我也在 [runtimes/README.md](C:/Users/wangq/Documents/Codex/ccpe-system/runtimes/README.md:131) 加了入口索引。
以后任何业务系统要调用 CCPE Agent先让它读这两个文件
```text
C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccpe-agent-consumer-setup.md
C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\agent-invocation-packet.protocol.md
```
然后它必须在自己项目里生成一个 project-local registry例如
```text
ccpe\agent-registry.yaml
```
或者在 workbench 项目里:
```text
audit\ccpe-agent-registry.yaml
```
核心规则已经写进新文件:业务系统不能只说“调用张辽”;它必须先把 `张辽` 绑定到:
```text
C:\Users\wangq\Documents\Codex\ccpe-system\agents\lite\zhang-liao.prompt.md
```
同理,巨人和认知显影也必须绑定 canonical prompt。每次调用前还要生成 `agent-invocation-packet.md`,真正启动子线程后才允许保存 `returned-output.md`。`prompt-to-send.md` 或 packet 本身都不算执行结果。
你以后可以直接把这段话丢给任何业务项目:
```md
Before invoking any CCPE Agent, read:
1. C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\ccpe-agent-consumer-setup.md
2. C:\Users\wangq\Documents\Codex\ccpe-system\runtimes\hybrid\agent-invocation-packet.protocol.md
Then create or repair the project-local CCPE agent registry and invocation policy.
Do not invoke a CCPE participant until every participant name is bound to a canonical_artifact_path, the canonical artifact is readable or pasted, agent-invocation-packet.md will be written, and returned-output.md will only be saved after a real participant returns.
```
验证过新文件已落盘README 已引用,中文路径/名称用 UTF-8 读取正常。尚未 commit。