Skip to content

ACCEPTANCE.md

Latest commit

 

History

History
247 lines (166 loc) · 4.54 KB

ACCEPTANCE.md

File metadata and controls

247 lines (166 loc) · 4.54 KB
Raw

workspacecord 验收清单

一、本地基础验收

1. 命令与构建

workspacecord help
pnpm typecheck
pnpm build
pnpm test

期望：

  • 全部成功
  • workspacecord help 能看到 config / project / daemon

2. 全局配置

workspacecord config list
workspacecord config path

期望：

  • 能看到 DISCORD_CLIENT_ID / DISCORD_GUILD_ID / DISCORD_TOKEN / ALLOW_ALL_USERS
  • 配置文件路径可读

3. 显式项目挂载

在仓库目录执行：

workspacecord project info
workspacecord project list

期望：

  • 当前项目名为 workspacecord
  • 路径为当前仓库根目录
  • Discord 绑定若未执行 /project setup 则显示 pending

二、Discord 冒烟验收

1. 启动机器人

workspacecord

期望：

  • 进程启动成功
  • Discord 中命令已注册

2. 绑定项目

在目标服务器某个 Category 下任意文本频道执行：

/project setup project:workspacecord

期望：

  • 返回绑定成功
  • 自动创建或复用 #history forum
  • /project info 能看到本地路径与 history

3. 创建主代理会话

/agent spawn label:smoke-main

期望：

  • 在当前 Category 下创建新文本频道
  • 频道里有欢迎信息和 mode 按钮

4. 创建子代理

进入主会话频道后执行：

/subagent run label:smoke-sub

期望：

  • 在主会话频道下创建 thread
  • /subagent list 可看到子代理

5. Shell 冒烟

在主会话频道执行：

/shell run command:pwd

期望：

  • 返回当前项目路径

6. 归档

在主会话频道执行：

/agent archive

期望：

  • 主会话被归档
  • #history forum 出现新帖子

三、更深集成测试脚本

运行脚本

pnpm test:integration:smoke

脚本会自动：

  • 读取全局配置
  • 确认已挂载项目
  • 登录 Discord
  • 创建临时 Category/频道（如无现有绑定）
  • 执行 /project setup 等价逻辑
  • 创建主会话
  • 创建子代理
  • 执行 shell 冒烟
  • 执行归档
  • 输出报告到：
local-acceptance/workspacecord-integration-report.json

四、若要做真实 Provider 出流测试，还需要你提供

Claude

需要其一：

  • 全局配置中的 ANTHROPIC_API_KEY
  • 或环境变量 ANTHROPIC_API_KEY

可选：

  • ANTHROPIC_BASE_URL

Codex

需要其一：

  • 全局配置中的 CODEX_API_KEY
  • 或环境变量 CODEX_API_KEY

可选：

  • CODEX_BASE_URL
  • CODEX_PATH

五、下午验收时我建议你重点看

  • 项目挂载是否仍然显式存在
  • Discord Category 绑定是否正确
  • 主会话/子代理/thread 层级是否符合预期
  • #history 是否工作
  • 命令面是否已经完全 workspacecord 化

六、补充能力验收

1. 项目级人格 / 技能 / MCP

在已绑定项目的分类中执行：

/project personality prompt:你是一个严格的软件架构师
/project skill-add name:smoke prompt:请总结当前任务：{input}
/project mcp-add name:demo command:node args:server.js
/project info

期望：

  • 人格可保存并在 /project info 或后续会话中生效
  • skill 可注册、列出、运行
  • MCP 服务配置可增删查

2. 监控模式与远程审批

在控制频道执行：

/agent spawn label:monitor-main mode:monitor provider:codex

期望：

  • 会话可以进入 monitor 模式
  • 需要人工批准时会在 Discord 中出现可处理的交互卡
  • 批准 / 拒绝后会话状态正确回落或继续

3. 本地 Codex 托管启动与会话发现

本地执行：

workspacecord codex --cwd <project-path>

期望：

  • 会话被守护进程发现或复用
  • 状态监控可见
  • 非受管会话与受管会话提示清晰区分

七、运行主路径核对

建议在阅读源码或做冒烟验收时确认当前主路径为：

bot.ts -> BotEventRouter -> command/message/button handlers
       -> thread-manager façade
       -> session-registry / state-machine / panel-adapter / provider runtime

期望：

  • 入口分发唯一
  • 会话状态来自单一状态机路径
  • thread-manager 更像 façade，而不是新的巨石中心
  • 状态卡 / 摘要 / 交互卡由面板链路统一协调

八、维护性验收关注点

下午验收时额外建议关注：

  • src/command-handlers.ts 是否已明显减薄
  • src/session-executor.ts 是否仍承担过多职责
  • src/thread-manager.ts 与 src/session-registry.ts 的职责是否可一句话说清
  • bot.ts 是否已经只负责装配与启动
  • README 与实际能力面是否一致