SharedGround
github.com/franklin625-xn/SharedGround →

From Human-AI Interaction
to Human-Agent Collaboration

从"人与 AI 交互"走向"人与 Agent 协同"
SharedGround explores a new way of working: the Human and the Agent share the same evolving task, act without waiting for strict turns, and continuously adapt to each other.
SharedGround 探索一种新的工作方式:Human 与 Agent 共享同一个持续变化的任务状态,不再严格轮流行动,而是在过程中不断相互适应。

Research is the first test case. The real question is how humans and agents work together.

AI Product Design Agent Workflow Human-in-the-loop Structured Actions Controlled Autonomy
The shift: from asking AI for outputs to working with an Agent inside a shared task.
真正的变化:不是向 AI 索取结果,而是与 Agent 共同推进任务。

Interaction is not collaboration.

能对话,不等于能协作。

Interactive AI

Human 提交任务 → AI 独立处理 → Human 等待 → AI 返回结果 → Human 再反馈

Human 只能等。AI 看不到 Human 中途的修改。只拿到结果,看不到判断过程。

Collaborative Agent

Human 和 Agent → 共享同一个任务状态 → 可以交错行动 → 彼此读取最新修改 → 共同形成结果

Agent 不覆盖 Human。Human 不等待 Agent。双方在过程中相互适应。

SharedGround 不是让 AI 更好地回答 Human,而是让 Human 和 Agent 成为同一个任务中的两个行动者。

What collaboration actually looks like

一个真实任务:欧盟产业政策如何影响中国电池企业赴欧投资?
1

Agent proposes

Agent 阅读上传的 Markdown 资料,提取 Evidence,提出 Claim:

"欧盟产业政策正在普遍要求外资企业本地化生产。"

2

Human revises

研究员认为判断太绝对,不等 Agent 完成就直接修改:

"本地化压力主要集中在获得公共支持和涉及战略供应链的行业。"

3

System protects

Agent 此前已基于旧 Claim 准备更新。系统发现版本冲突。

拒绝旧写入。没有覆盖 Human 的修改。

4

Agent adapts

Agent 重新读取修改后的 Claim,补充 Evidence,据此更新 Brief。

协作继续。不是重来。

这不是一次"提问—回答",而是一段共同完成任务的过程。

A shared task, not a shared chat.

共享的不是聊天记录,而是任务本身。
Sources Evidence Claims Human Decisions Brief
Sources Human 和 Agent 共同查看的材料 Evidence 真正进入判断的事实 Claims 可被提出、修改、争议和确认的结论 Human Decisions 关键判断由 Human 裁决 Brief 由已确认判断形成的最终交付

一旦任务被拆成可共同操作的对象,Human 和 Agent 才能真正协作,而不是只在聊天里交换文字。

How changes flow

Human changes
Action & Control Layer
validation · permissions · version checks
Shared Task State
Agent actions
Agent 不能直接改 Workspace,只能提出 Action。
Human 的最新修改受到保护。每次变化都留下记录。

See SharedGround in action

观看一段真实的 Human-Agent 协作过程

See how Human and Agent revise claims, exchange control, protect human decisions, and produce a traceable final brief.

SharedGround Human-Agent Collaboration product demo cover
Human revision · Version protection · Human request · Traceable output 在 B 站打开 →

How SharedGround works

SharedGround:通过结构化动作协同完成任务
System mechanism

Human and Agent operate inside the same evolving workspace.

人和 Agent 共享状态,Agent 通过 Action 工作,Reducer 负责权限、版本和写入控制。
SharedGround mechanism: human operations, shared workspace, agent execution loop, human requests, guardrails, and traceable outputs
The diagram is intentionally shown as a system artifact rather than a full-bleed hero image, so it stays consistent with the case-study page’s restrained editorial style.
V0.1 shared the workspace. V0.2 began to share the work.
V0.1 共享了工作区。V0.2 开始共享工作过程。

From sharing a workspace
to sharing the work

从"共享一个工作区"到"真正共享工作过程"

V0.1

Human 和 Agent 终于看见了同一个任务状态。

但仍然:双方大体上还是轮流行动。

  • 双方看同一状态
  • Human 可以修改 AI 结果
  • Agent 可以请求 Human 决策

V0.2

Human 和 Agent 不再需要等待对方完成整轮工作。

  • Agent 以小步骤推进
  • 每一步读取最新状态
  • Human 可以中途修改
  • 旧 Agent 更新不会覆盖 Human
  • Brief 可以识别自己是否过时
V0.1 解决"共同看什么"。V0.2 解决"如何共同做事"。
Technical: Continuous step loop · object versioning · stale write rejection · Brief derivation stale selector · Pause / Resume with runId

The product decisions behind SharedGround

我做出的关键产品判断
01

不做聊天框,做共享任务状态。

协作不以消息流为中心,而是围绕一组持续演化的共享对象。

02

不让 Agent 直接生成整份 Workspace,而是提交有限动作。

14 种 Action,每次最多 3 个。校验后统一入口。

03

Human 的修改优先于旧 Agent 结果。

Agent 不能覆盖 Human。旧版本写入被拒绝而非静默合并。

04

Agent 不确定时必须询问或等待。

REQUEST_HUMAN_INPUT 和 WAIT 显式交换控制权。不是越自主越好。

05

不只评估最终报告,还评估协作过程。

Outcome · Process · Traceability 三层。支持 JSON / Markdown 导出。

The Agent is a participant, not a generator.

Agent 是任务参与者,不是内容生成器。

Observe → Read latest task state
Decide → Choose next goal and actions
Act → Submit structured actions
Feedback → Receive accepted / rejected results
Observe again → Next step reads state again

Agent 的价值不在于一次生成多少内容,而在于它能够在环境中持续行动、接收反馈并调整。

I led: product framing · protocol design · object model · permission rules · V0.1→V0.2 iteration · acceptance criteria · coding agent orchestration
Codex supported: implementation · refactoring · automated tests · code review
Technical Notes

Stack: Next.js 15 · TypeScript · Zustand · Zod · Vitest · Tailwind CSS · localStorage
Agent: 14 structured action types · max 3 per turn · schema-validated (Zod) · expectedVersion on all update actions
Reducer: single mutation point · permission checks · version checks · BRIEF_CLAIM_UNREVIEWED · AGENT_STATE_REGRESSION · LINE_RANGE_INVALID · CONTENT_IMMUTABLE
Step Loop: per-step AbortController · stale response discard (before JSON parse) · Pause invalidates runId · Resume creates fresh runId
Evaluation: 6 V0.2 metrics (stale rejections · message ack · agent action rate · source location · brief stale · discarded responses)
Tests: 125 Vitest cases · typecheck · build

Boundaries: single-user · no database · no Redis / WebSocket / SSE · no CRDT · no RAG · no MCP · no multi-agent · not production-ready

github.com/franklin625-xn/SharedGround