--- artifact_type: ccpe-creation-brief name: viewpoint-discussion-distillation-creation-brief requested_artifact: Viewpoint Discussion Distillation Runtime author: CCPE System created: 2026-06-06 status: draft based_on: CCPE System mode: creator review_status: needs-user-review next_action: confirm knowledge-vault directory convention before running source processing --- # CCPE Creation Brief: Viewpoint Discussion Distillation Runtime ## 1. User Request ```text Original Request: 用户在 knowledge-vault/diary 中有一份与 GPT 的长讨论稿,共 7 个回合、约 5 万字符。讨论从一篇网文开始,逐步进入用户模型的讨论优化和实践推演。用户希望打造一个 Agent 或 Skill,对原始素材文档进行拆分,动态捕捉素材里的领域,自动分类汇总成不同文档。最终拆分后的文档应包含素材里的内容,使原始素材可被丢弃且没有信息衰减、失真或压缩。 User Goal: 把“确定观点”阶段的大型讨论稿,从一个难以复用的原始会话文件,转化为 knowledge-vault 中可长期保存、可检索、可分流到后续任务的观点材料包。后续任务可能是写作项目,也可能是量表抽取、现有模型更新、系统/工程建设、待办事项、继续讨论或暂存积累。 Known Constraints: - 该工作属于写作总流程中的第 2 步“确定观点”的细化,但不一定进入第 3 步“确定创作”。 - 原始讨论稿可能很长,主题抽取需要分步、增量、可回溯。 - 拆分后的文档必须尽量无损,不能只做摘要。 - 原始素材中的领域和主题不能预设死,需要运行时动态发现。 - knowledge-vault 是实际调用和落盘方。 - ccpe-system 负责定义可调用的 Agent / Skill / Runtime,不直接承担知识库仓储。 - writing-workbench 只在用户决定进入创作项目后消费整理后的观点材料包;其他任务应被分流到对应的知识库、CCPE、工程或待办工作流。 - 任何 canonical Agent / Skill / Runtime participant 都必须有真实调用边界:Agent Invocation Packet、prompt-to-send returned output 或 Skill execution record;主会话不得模拟正式参与者输出。 ``` ## 2. Intended Use ### 2.1 Primary Use Case 当用户在 `knowledge-vault/diary/` 或 `knowledge-vault/discussions/` 中积累了一份大型 LLM 观点讨论稿,并希望把它转化为可长期使用的观点材料时,由 `knowledge-vault` 调用本 Runtime。Runtime 将源文档切分为可追踪信息块,增量发现主题,建立主题文档,把原始内容搬运到对应主题下,再做结构化整理与覆盖率审计。 ### 2.2 Secondary Use Cases ```text - 将多平台 LLM 讨论稿整理成 knowledge-vault 的观点材料包。 - 从一个观点讨论中识别多个潜在后续产出方向,包括文章、量表、模型更新、系统/工程建设、待办事项、继续研究或暂存积累。 - 为后续 writing-workbench 项目提供可选 writing-intake-packet。 - 为后续 CCPE 建模、Skill 提取、Runtime 设计或工程建设提供 task-intake-packet。 - 在整理过程中识别候选认知模型、实践方法、待验证问题、可转 Skill 的方法和可执行任务。 - 为大型讨论稿建立 source-map、topic-map、routing-log 和 coverage-audit。 ``` ### 2.3 Non-Goals ```text - 不直接写文章。 - 不直接创建 writing-workbench 项目。 - 不自动决定某个观点必须进入创作、工程建设、模型更新或其他任务。 - 不把原始讨论稿压缩成单篇总结。 - 不删除、覆盖或移动 knowledge-vault 中的原始 diary / discussion 文件。 - 不在未审计覆盖率前宣称源素材可丢弃。 - 不把每个有趣观点都提升为 Model Card。 ``` ## 3. Target User ```text Primary User: 用户本人,作为观点讨论、知识沉淀和写作流程的最终决策者。 Secondary Users: 未来在 knowledge-vault 中运行整理流程的 Codex / Claude Code / OpenClaw 类 agentic 工作助手。 Human Role: 主题边界裁决者、观点是否进入后续任务的决策者、模型候选状态确认者、任务分流确认者、最终归档确认者。 ``` ## 4. Target Platform ```text Codex Claude Code OpenClaw Platform-neutral Markdown Manual workflow ``` Platform notes: ```text 第一版以 Codex 文件工作流为主,但生成的 Agent / Skill / Runtime Spec 应保持平台中立。实际调用在 knowledge-vault 中完成;CCPE 只提供调用协议、角色规格、技能规格和运行边界。 ``` ## 5. Artifact Classification ### 5.1 Primary Classification ```text Hybrid Artifact ``` ### 5.2 Secondary Components ```text - CCPE-Runtime: viewpoint-discussion-distillation.runtime.md - CCPE-Agent: topic-discovery-router.agent.md - CCPE-Agent: lossless-coverage-auditor.agent.md - CCPE-Skill: conversation-segmentation.skill.md - CCPE-Skill: evidence-routing-and-topic-doc-builder.skill.md - Optional Model Mining Report: candidate models discovered during discussion processing ``` ### 5.3 Why This Classification? ```text 该任务不是一个单 Agent 能稳定完成的“总结”任务,而是一个长文档、多阶段、动态分类、文件落盘、覆盖率审计和人类确认并存的工作流。它需要 Runtime 管理状态、Agent 做判断、Skill 执行稳定方法,并保留人工确认门。 ``` ## 6. Operating Mode ```text Hybrid Mode ``` Explanation: ```text 主题发现、模型识别和观点边界判断具有深度认知性质,需要保留人工确认;文档切分、来源编号、路由日志、覆盖率审计和文件生成具有可自动化性质。两者必须分层。 ``` ## 7. Depth vs Automation Orientation ```text Hybrid ``` Explanation: ```text Depth-Oriented 部分:判断讨论中的核心观点、模型机制、主题边界、实践意义和是否进入后续任务。 Automation-Oriented 部分:按回合切分、chunk 编号、生成 source-map、写 routing-log、创建主题文档、检查覆盖率。 ``` ## 8. Cognitive Models Involved ### 8.1 Existing Models ```text - model_id: none-required model_name: none model_card_path: none ``` ### 8.2 New or Candidate Models ```text - provisional_model_name: Lossless Viewpoint Distillation reason: 长讨论稿转观点材料包时,需要一种“先无损搬运,后结构优化”的整理模型。 should_create_model_card: no - provisional_model_name: Topic Graph Routing reason: 主题不是一次性固定分类,而是通过增量路由、合并、拆分和人工确认形成主题图谱。 should_create_model_card: no ``` ### 8.3 Model Card Need ```text optional ``` Explanation: ```text v0 阶段不先创建 Model Card。等真实运行几次后,再判断“无损观点蒸馏”是否是稳定认知模型,还是只是 Runtime 的工程方法。 ``` ## 9. Skills Needed ### 9.1 Existing Skills ```text - skill_id: ccpe-forge path: .codex/skills/ccpe-forge/SKILL.md purpose: 创建和分类本批 CCPE 工件。 ``` ### 9.2 New Skills to Create ```text - skill_name: conversation-segmentation skill_type: transformation skill reason: 按标题回合、段落和语义块切分长讨论稿,并生成稳定 source block id。 - skill_name: evidence-routing-and-topic-doc-builder skill_type: workflow / knowledge management skill reason: 将源信息块路由到主题文档,维护 source-map、topic-map、routing-log 和主题文档骨架。 - skill_name: coverage-audit-checklist skill_type: evaluation skill reason: 检查每个源信息块是否有去处,识别未归档、重复归档、过度改写或来源断裂。 ``` ### 9.3 Skill Need ```text required ``` Explanation: ```text 切分、路由、文档构建和覆盖率审计是可复用且需要稳定执行的能力,应作为 Skill 定义。Agent 不应手工临场发明这些步骤。 ``` ## 10. Runtime Need ```text required ``` ### 10.1 Runtime Type ```text hybrid-runtime ``` ### 10.2 Runtime Explanation ```text 源文档长、主题动态、需要多轮增量处理、需要文件状态和覆盖率审计,并且存在人类确认门。Runtime 负责串联切分、主题发现、路由、生成、审计、优化和交接。 ``` ## 11. Human Decision Gates ```text Gate 1: - Trigger: Runtime 完成 Pass 1 初步切分和候选主题发现。 - Decision: 用户确认主题粒度是否过粗、过细或方向错误。 - Possible outcomes: 继续路由 / 合并主题 / 拆分主题 / 暂停并补充说明。 Gate 2: - Trigger: Runtime 完成第一轮 topic-map 和 material-routing-log。 - Decision: 用户确认哪些主题文档需要保留,哪些只是临时桶。 - Possible outcomes: 创建主题文档 / 调整分类 / 标记为待归档杂项。 Gate 3: - Trigger: 覆盖率审计发现未归档、低置信度归档或潜在失真。 - Decision: 用户确认修复策略。 - Possible outcomes: 重新路由 / 保留重复归档 / 建立新主题 / 标记为噪音但保留索引。 Gate 4: - Trigger: 主题文档结构优化完成。 - Decision: 用户确认是否生成后续任务分流包,或只留在 knowledge-vault。 - Possible outcomes: 进入 writing-workbench / 进入 CCPE 建模或 Agent-Skill-Runtime 设计 / 进入系统工程或待办 / 保持观点材料 / 继续深挖模型。 ``` ## 12. Authority and Automation Boundary ### 12.1 Allowed Autonomous Actions ```text - 读取用户指定的源讨论稿。 - 按回合和语义块生成 source-map 草案。 - 生成候选 topic-map。 - 为每个 source block 提出一个或多个主题归属。 - 创建工作台目录和草案文档,前提是目标路径已由 handoff 或用户确认。 - 在主题文档中保留原文承载层、结构化整理层和来源索引层。 - 生成 coverage-audit 草案。 ``` ### 12.2 Actions Requiring Confirmation ```text - 覆盖或移动原始 diary / discussion 文件。 - 删除任何 source block。 - 宣称原始素材可以丢弃。 - 将候选模型提升为 Model Card。 - 将某个主题材料包交给 writing-workbench、CCPE 建模、工程建设或其他执行工作流。 - 修改 knowledge-vault 的全局目录规范。 - 更新 Model Index、writing-workbench 项目结构或工程仓库结构。 ``` ### 12.3 Forbidden Actions ```text - 用摘要替代原始信息承载层。 - 为了结构整洁而丢弃例子、实践、反复推敲过程或模型失败边界。 - 自动把所有主题都变成文章项目、工程项目、模型更新或待办事项。 - 自动把原始讨论稿从 diary 移出或删除。 - 在 coverage-audit 未通过时输出“无损完成”。 ``` ## 13. Input / Output Contract ### 13.1 Inputs ```text - source_document_path: knowledge-vault/diary 或 discussions 中的原始讨论稿路径 - source_type: diary | discussion | multi-platform-transcript | research-discussion - known_round_boundary: Markdown H1 标题或用户指定回合边界 - intended_use: viewpoint-development | downstream-task-routing | writing-intake | model-mining | system-building | scale-extraction | todo-extraction | archive-cleanup - output_workspace_path: knowledge-vault 中本次观点拆分工作目录 - optional_user_seed_topics: 用户已知主题或禁止合并的概念 - optional_downstream_intent: 是否可能进入 writing-workbench、CCPE、工程项目、量表抽取、待办或继续研究 ``` ### 13.2 Outputs ```text - 00-source-map.md - 01-topic-map.md - 02-material-routing-log.md - topics/{topic-slug}.md - audits/coverage-audit.md - audits/distortion-risk-log.md - handoff/downstream-task-routing.md - handoff/writing-intake-packet.md - handoff/ccpe-runtime-run-report.md - optional model-mining/candidate-models.md ``` ### 13.3 Output Format Notes ```text 主题文档必须至少包含三层: 1. Source Material Layer: 原文片段或足够完整的源内容承载,带 source block id。 2. Structured Viewpoint Layer: 按观点、问题、模型、实践、例子、待验证边界整理。 3. Source Index Layer: 回链 source-map、routing-log 和原始文档位置。 ``` ## 14. Evaluation Criteria ```text - 每个 source block 是否都有明确归属或明确保留为未归档。 - 每个主题文档是否能脱离原始讨论稿被理解和复用。 - 主题文档是否保留原始素材的概念力度、实践细节和推理痕迹。 - 结构优化是否与原文承载层分离。 - 路由日志是否能解释为什么某段进入某主题。 - 低置信度路由是否被标记,而不是伪装成确定分类。 - 写作、建模、工程建设、量表抽取和待办入口是否都只是可选 handoff,不强制启动。 - knowledge-vault 是否仍是观点材料的实际归档位置。 - writing-workbench 是否只消费整理后的 writing-intake-packet,而非原始讨论稿。 - CCPE / 工程 / 待办类任务是否通过 downstream-task-routing 分流,而非混在主题文档里。 - ccpe-system 是否只定义能力,不接管知识库内容。 ``` ## 15. Proposed Files ```text - workbench/analysis/viewpoint-discussion-distillation-creation-brief.md artifact_type: ccpe-creation-brief purpose: 定义长讨论稿无损主题拆分与观点材料沉淀 Runtime 的目标、边界和组件。 priority: high - workbench/analysis/knowledge-vault-viewpoint-runtime-handoff.md artifact_type: handoff purpose: 给 knowledge-vault 的接收说明,明确目录、调用方式、输入输出和跨项目边界。 priority: high - runtimes/hybrid/agent-invocation-packet.protocol.md artifact_type: ccpe-runtime-subprotocol purpose: 定义 canonical CCPE participant 的真实调用边界、prompt-to-send、Skill execution record 和 no-simulation 要求。 priority: high - runtimes/hybrid/viewpoint-discussion-distillation.runtime.md artifact_type: ccpe-runtime purpose: 定义由 knowledge-vault 调用的观点讨论稿拆分 Runtime。 priority: high - agents/agent-specs/topic-discovery-router.agent.md artifact_type: ccpe-agent purpose: 负责候选主题发现、主题图谱维护和路由判断。 priority: later - agents/agent-specs/lossless-coverage-auditor.agent.md artifact_type: ccpe-agent purpose: 负责覆盖率、失真风险和可丢弃原素材条件审计。 priority: later - skills/workflow/conversation-segmentation.skill.md artifact_type: ccpe-skill purpose: 稳定切分长讨论稿并生成 source block id。 priority: later - skills/workflow/evidence-routing-and-topic-doc-builder.skill.md artifact_type: ccpe-skill purpose: 稳定执行信息块路由、主题文档生成和日志维护。 priority: later ``` ## 16. Open Questions ```text 1. knowledge-vault 中观点开发工作目录应放在 discussions/viewpoint-development/,还是继续沿用 discussions/project-thinking/ 的风格? 2. 主题文档是否允许同一个 source block 重复进入多个主题,还是主归属 + 引用关系? 3. 原始 diary 文件在 coverage-audit 通过后是否仍保留为原始档案,还是只标记为 superseded? 4. 是否需要为“进入写作”的材料包定义 writing-workbench intake schema? 5. 是否需要为模型更新、量表抽取、系统工程和待办事项定义统一 downstream-task-routing schema? ``` ## 17. Acceptance Criteria The creation is acceptable when: ```text Classification is correct. The artifact is not reduced to a single summary agent. The Runtime caller is clearly knowledge-vault. The CCPE / Knowledge / Writing responsibilities are separated. Lossless preservation is enforced by source block ids and coverage audit. Human decision gates exist before topic finalization and downstream task handoff. No formal participant output is accepted without an invocation packet, prompt-to-send returned output, or Skill execution record. Output format is usable by knowledge-vault without changing writing-workbench. The original discussion's conceptual force and process trace can be preserved. ``` ## 18. Recommended Next Action ```text 本 Creation Brief、knowledge-vault handoff、Runtime、Agent、Skill 和 Agent Invocation Packet Protocol 已形成第一版配套。下一步先确认 Knowledge Vault 目标目录和调用方式;不要在 CCPE 项目中直接拆分 2026-06-05.md 原始讨论稿。 ```