Skip to content

clarification-system.md

Latest commit

 

History

History
51 lines (38 loc) · 3.04 KB

clarification-system.md

File metadata and controls

51 lines (38 loc) · 3.04 KB
Raw

Clarification System — 组合

English

本文说明 Clarification & Research 的组合：入口、handoff 与停止。追问逻辑在各 SKILL.md 与 references/ 中。

家族

                 socratic  （model-invoked 引擎）
                    │
      ┌─────────────┼─────────────┐
      ▼             ▼             ▼
   clarify   project-clarify  decision-map
                │                  │
                └───── unknown ────┘
                       │
            ┌──────────┼──────────┐
            ▼          ▼          ▼
        research  prototype  to-questionnaire
  • socratic — 核心引擎：动态、decision-owned 的追问，无固定问卷，区分事实与用户决策；本身不是项目流程，被其他 Skill 调用。
  • clarify — user-invoked 单入口，面向无项目上下文的模糊想法。一次 $clarify 启动连续会话，后续普通回复继续 socratic；每轮保持对话式，在有依据时给建议，并在共同理解确认、退出或切换 workflow 后结束。不产 SPEC，不自动串联。

面向项目的澄清

Skill 入口 如何用 socratic Handoff 停止点
project-clarify — user-invoked 现有项目仍有未决决策 先检查： README、AGENTS.md、CLAUDE.md、既有文档/SPEC/源码；再 对仅需用户决策的缺口调 socratic 供 project-spec 的有界 handoff（仍模糊则回 decision-map） 止于澄清 summary，不建 SPEC/tickets
decision-map — user-invoked 大型、模糊、跨会话、依赖多 在 .scratch/<effort>/map.md 及子 tickets 上维护决策地图，可按 unknown 路由调 socratic 与 research/prototype/to-questionnaire 决策收敛后交 project-spec 止于地图更新；工作留痕于 tracker

Unknown 路由

Unknown
  ├─ 须由用户决定          → socratic
  ├─ 外部事实              → research（PORT，读一手来源）
  ├─ 需实验                → prototype（一次性探针）
  └─ 信息在他人处          → to-questionnaire（PORT，生成问卷）

调能力，不抄指令；research/prototype 为只读查证，to-questionnaire 返回问卷由用户转交。

Handoff 规则

  • clarify 止于共同理解确认或 blocker；出现正式项目时由用户显式调 project-clarify/decision-map，不自动串联。
  • project-clarify 交 project-spec；project-spec 若仍有阻塞决策则返回 project-clarify。
  • decision-map 清雾后交 project-spec。

见 project-workflow 了解澄清如何进入规划；入口不清时用 ask-light。