4

Home

ila edited this page 2026-08-07 16:47:52 +08:00

Table of Contents

• CMRoubao 项目文档
• 核心文档
• 设计与集成
• 任务记录
• docs/README.md 原文
• 项目文档导航
• 一句话定位
• 核心文档
• Harness 辅助文档
• 文档职责

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

同步来源：docs/README.md · commit afc651f75a3a

CMRoubao 项目文档

本 Wiki 从仓库 docs/ 目录同步。

核心文档

• AI 开发入口
• 项目愿景
• 需求
• 技术栈
• 架构设计
• 编码规则
• 任务路线图
• 用户故事清单
• 交互清单
• Agent 上下文清单
• API 合约
• 干净收尾检查清单
• 当前实现状态
• 路由与页面结构

设计与集成

• 设计原型输入约定
• 顺运宝 ERP 字段契约
• 老板汇报 PPT 与流程图

任务记录

• 任务文件
• T-001
• T-002
• T-003
• T-004
• T-101
• T-102
• T-103
• T-104
• T-201
• T-202
• T-203
• T-204
• T-205
• T-206
• T-207
• T-208
• T-209
• T-210
• T-211
• T-212
• T-213
• T-214
• T-215
• T-216
• T-217
• T-218
• T-219
• T-220
• T-221
• T-222
• T-223
• T-224
• T-225
• T-226
• T-227
• T-228
• T-229
• T-230
• T-231
• T-232
• T-233
• T-234
• T-235
• T-236
• T-237
• T-238
• T-239
• T-240
• T-241
• T-242
• T-243
• T-244
• T-245
• T-246
• T-247
• T-248
• T-249
• T-250
• T-251
• T-252
• T-253
• T-254
• T-255
• T-256
• T-257
• T-258
• T-259
• T-260
• T-261
• T-262
• T-263
• T-264
• T-265
• T-266
• T-267
• T-268
• T-269
• T-270
• T-271
• T-272
• T-273
• T-274
• T-275
• T-276
• T-277
• T-278
• T-279
• T-280
• T-281
• Task-Template

---

docs/README.md 原文

项目文档导航

一句话定位

采购自动化验证系统是一个由管理 Web 端创建任务、Android 采购端领取任务，并通过 AI 辅助完成拼多多检索和候选判断的系统；第一版先验证“创建 -> 领取 -> 搜索 -> 人工确认 -> 回传”的最小闭环。

VLM 和拼多多工作流在手机本地执行；管理后端只负责任务控制、取消和结果审计。

核心文档

• ../AGENTS.md：AI coding agent 的仓库级权威规则。
• 00-ai-start-here.md：每次开发的入口和开工流程。
• 01-vision.md：目标用户、价值、产品原则和非目标。
• 02-requirements.md：MVP 范围、验收标准和待确认事项。
• 07-user-stories.md：角色目标和业务验收场景。
• 08-interaction-checklist.md：Web 与 Android 的界面行为。
• 03-tech-stack.md：已定技术选型、待验证项和计划命令。
• 04-architecture.md：系统边界、数据流、状态机和数据模型。
• api.md：管理端和 App 共用的 API 合约。
• routes.md：管理 Web 路由和 Android 页面结构。
• 05-coding-rules.md：编码、安全和验证硬规则。
• 06-tasks.md：只读路线图和建议任务拆分。
• tasks/README.md：一任务一文件的默认执行协议。
• current-state.md：当前仓库现实和 blocker。

Harness 辅助文档

• agent-context.json：机器可读的按任务类型文档路由。
• agent-context.md：上下文清单的使用方式。
• clean-state-checklist.md：每轮结束前检查项。
• design/README.md：P0 页面低保真原型约定。
• ../progress.md：可选的项目级大事记。
• ../init.ps1 / ../init.sh：标准验证入口；当前等待 T-001 写入真实命令。

文档职责

• “做不做、怎么算完成”以 02-requirements.md 为准。
• “谁要获得什么结果”以 07-user-stories.md 为准。
• “界面如何反馈”以 08-interaction-checklist.md 为准。
• “系统如何分层、状态如何变化”以 04-architecture.md 为准。
• “接口字段和错误”以 api.md 为准。
• “当前代码是否存在、什么命令能跑”以 current-state.md 和真实验证结果为准。
• 任务规格、状态和证据以 docs/tasks/T-<编号>.md 为准。

需求或架构变化时同步所有受影响的文档，不允许代码独自形成另一套事实。