产品设计说明

艺爪编程是一套任务驱动的 AI 编程协作系统：你用手机给 AI 团队下任务，Agent 在你自己的电脑上执行，过程与结论都留在一条可追溯的任务时间线里。

它不是「一个更聪明的聊天窗口」，而是「一支可以指挥的 AI 团队」。

它解决什么问题

一个懂业务但不一定懂技术的人，手上有几台电脑、想同时推进几件事，今天会遇到三个卡点：

1. 会话会散。每个话题开一个对话框，关掉就找不回上下文，人脑只能同时跟住三五个。
2. Agent 在干什么看不见。它读哪些文件、改了什么、跑到哪一步，你只能等结果。
3. 做完没有凭据。谁决定的、谁审的、什么时候算完，散在聊天记录里，事后说不清。

艺爪编程的答案是把「会话」换成「任务」：一个任务是一个有边界、有责任人、有阶段、有账本的工作单元。

核心概念

任务：唯一的业务单元。必须挂在一个代码库上（团队由库推导），有标题、描述、阶段、负责人。

任务树：任务可以挂子任务、关联其他任务，可多级。父任务负责这一层的协调。

分身：同一个 Agent 在不同任务是不同分身——上下文、工作目录互不共享，可以并行。

角色：负责人是人（决策与验收）；执行者、审查者是 Agent（干活与把关）。

阶段：讨论 → 实施 → 验收 → 完成。阶段只由流程动作改变。

评论：唯一的沟通通道。Agent 在终端里说的话别人看不到，必须落成评论。

会话：技术细节，不是产品概念。它由「任务 + Agent + 电脑」派生，你在任务里看到的是执行过程。

一句话概括：人决定做什么、谁来做、什么时候算完成；系统负责记下来、送对人、跑起来。

一次任务怎么走完

以「修一个线上问题」为例：

1. 建任务：挂在对应代码库上，写清背景与现象，指定执行者与审查者。
2. 讨论：执行者读代码、查相关任务、出提案；审查者对照事实审。方向不清就先讨论，不急着改代码。
3. 批准：负责人确认提案，任务进入实施。普通评论不代表批准，只有明确的批准动作才算。
4. 实施：执行者改代码、开变更，边做边把进展写进任务。
5. 验收：执行者提交验收材料（交付范围、变更链接、测试证据），审查者复核，负责人确认。
6. 完成：任务关闭，时间线保留，任何人接手都能读懂来龙去脉。

跨任务怎么协调？两个机制：父子任务（子任务的阶段变化会自动写进父任务的时间线并唤醒父任务）和跨任务评论（直接去另一个任务里说话）。

信息架构

三层，加若干配置面：

• 归属层：团队 → 代码库。任务必须属于一个库，团队由库推导，权限沿这条线收敛。
• 工作层：任务树。任务是入口，也是上下文边界——讨论、审批、交付都在这里。
• 执行层：任务下的执行过程，以及代码库平台上的变更（PR/MR）。会话详情只是观察和排障入口。
• 配置面：Agent 编制（按电脑）、模型与供应商、凭证、记忆、团队与成员。

客户端只有两个入口：任务 和 我的。任务里是工作，我的里是配置。

技术架构与数据边界

客户端 ──HTTP/WebSocket──▶ Server（自托管）
                            · 任务 / 事件 / 成员 / 凭证 / 记忆 等中心事实
                            · 按电脑路由执行请求
                                 │ 反向隧道
                                 ▼
                          电脑 daemon × N
                            · 跑 Agent、Git、文件、资源隔离

三个要点：

1. Server 自托管，跑在你自己的一台电脑上，不经过我们的云。
2. 执行在设备。Agent 在你自己的电脑上跑，代码与凭证不出内网；只有模型推理的请求会出网。
3. 引擎可替换。同一套任务体系可以驱动多种编程引擎，引擎只是执行单元。

和 Super-agent 的区别

DeepSeek Harness 团队公开的《Super-agent 设计探索》描述的是「一个常驻、事件驱动、跨信道连续、能并发的 Agent 实体」，五个模块：双层架构（Router / Worker）、事件驱动、面向人的交互、存算分离、Watchdog。

我们解的是同一道题（多任务并发、上下文连续、人在环上），但结构和取舍不同：

三处最本质的差异：

1. Router 的形态。它是常驻会话，我们是任务树。任务树重、慢、要人参与，但每个分派决定都留在账本上；常驻会话快、自动，但决定只存在于一次推理日志里。企业场景要的是能追责的自主。
2. 连续性的载体。它把连续放在一个长期记忆的会话里；我们放在任务边界里——任务内的来龙去脉全在时间线，跨任务靠关联与检索。代价是「换个任务就不记得」，收益是上下文不会互相污染。
3. Loop 的位置。它把计算放云、设备只执行；我们反过来。这决定了「数据不出内网」，也接受「电脑关机任务就停」这个代价。

一句话：Super-agent 追求「更自主」，艺爪编程追求「可控的自主」。

有意不做的几件事

• 不让用户管会话。会话是内部实现，用户只面对任务。
• 不做投机执行、静默提交。没说过就改，和审批与审计语义冲突。
• 不做通用外部连接器。网络可达、分派逻辑高度个性化，交给用户自行接入。
• 不把审批降到工具级。我们的审批在业务层（提案、验收、确认），不是「允许执行这条命令」。

边界

• 电脑离线，任务就停。执行在设备上，这是「数据不出内网」的另一面。
• 只有一个信道：任务评论。IM、邮件、PR 评论不直接进入任务，需要自行接入。
• 跨任务没有共享上下文池，靠任务关联与搜索按需取用。
• 主动性有限：主要靠人点火，加上定时跟进与提醒。

要判断一个需求该不该做，可以问三个问题：它让任务更清楚，还是让会话更复杂？它让决定更可追溯，还是更隐蔽？它守住数据边界，还是为了便利让出去？