跳转至

听写助手对话记录:建立项目管理制度——重构 agents.md 与独立报价服务设计

记录编号:DLG-20260804-02 日期:2026-08-04 智能体:听写(文档编写助手) 参与方:项目发起人(用户)、听写 沟通渠道:AI 助手对话 主题:建立项目管理制度、确定项目名称与运营主体、独立术语表、创建报价服务与技术文档子目录


一、用户需求

本次对话延续首次对话(项目启动),用户提出以下需求(原文要点整理):

  1. 建立项目管理制度:完善 agents.md,补充目标、任务、进度、风险、质量、变更、决策、汇报等管理制度。
  2. 确定项目根目录与迁移约定:项目根目录为 d:\AC\TF\hk2026,后续可能迁移;所有文档使用相对路径。
  3. Git 版本管理:使用中国境内服务(如 Gitee)。
  4. 确定项目名称:新增参考资料 ref\pic-p2(品牌 VI 图片),参考后更新内容,重点确定项目名称。
  5. 附录取消:原 agents.md 的附录取消,其中术语表独立成文。
  6. 报价服务独立:报价是首个服务,先独立建子目录和设计。
  7. 技术文档独立:创建技术文档子目录。

二、工作过程记录

步骤 1:识别品牌 VI 图片,确定项目名称与运营主体

  • 用户新增 ref/pic-p2/ 参考资料(织布鸟品牌 VI:LOGO 规范、品牌色、包装、保修卡、服务回执、企业手册等 PNG 图片)。
  • 图片中含艺术字品牌中文名与英文名"WEAVELY",需通过 OCR 识别确认。

OCR 识别过程

环节 处理方式 结果
PDF 文本提取 公司介绍手册(DOC-P21)为图片型 PDF,超 10MB 限制;编写 Python 脚本用 pdfplumber 提取 15 页未提取到文本(图片型)
OCR 库检测 easyocr 未安装 安装 easyocr(清华镜像源)
模型下载 easyocr 模型从 GitHub 下载过慢且 MD5 校验失败 编写脚本用国内 GitHub 镜像(ghfast.top)下载 zh_sim_g2.zip 和 english_g2.zip,绕过 MD5 校验直接解压
中文艺术字识别 OCR 识别中文艺术字出现乱码 结合英文名 WEAVELY、Slogan"用心编织你的理想家居"及文案"以织物的温度",推断品牌中文名为"织布鸟"

确定结果(经用户确认):

内容
品牌中文名 织布鸟
品牌英文名 WEAVELY
品牌 Slogan 用心编织你的理想家居 Weave Your Smart Home
项目名称 香港配送+安装互联网平台
运营主体 织布鸟智居科技有限公司(WEAVELY TECHNOLOGIES LIMITED)

步骤 2:重构 agents.md 为项目管理制度总纲(V2.0)

将 agents.md 从"入口文档"升级为项目管理制度总纲,新增/完善以下内容:

章节 新增/完善内容
§一 文档定位 明确为管理制度总纲与协作者入口文档
§二 项目概述 确定项目名称、运营主体、品牌规范(品牌色色值)、业务模式、市场背景、六大场景、阶段规划
§三 文档体系 目录结构(含报价服务/技术文档子目录)、编号规则、核心参考资料索引、Git 版本管理规范
§四 管理制度 新增:目标管理、任务管理、进度管理、风险管理、变更管理、质量管理、决策机制、汇报机制
§五 团队角色 新增:RACI 权责矩阵(7 角色 × 9 职责)、角色核心职责表
§六 AI 协作 智能体定义(听写/代码助手/调研助手)、协作原则
§七 协作机制 沟通渠道、工作日志规范、会议机制
§八 工作流程 文档创建流程、评审确认、输出规范
§九 约束原则 数据准确、尊重意图、保密合规、价格透明、抽成合理、格式一致、相对路径、效率优先
附录 取消(术语表独立、报价参数独立至报价服务子目录)

Git 规范要点: - 托管服务:Gitee 码云(备选 CODING / 阿里云 Codeup) - 分支策略:轻量 Git Flow(main / dev / feature) - 提交规范:<类型>: <简述> - 全部使用相对路径,确保迁移有效

步骤 3:独立术语表

将原 agents.md 附录中的术语表独立为 术语表.md,扩充为五类:

类别 示例术语
品牌与主体术语 织布鸟 WEAVELY、织布鸟智居科技有限公司、香港配送+安装互联网平台
业务与平台术语 统一派单、动态报价模型、维修刺客、封顶价、加价险
香港本地化术语 唐楼、公屋、村屋、洋楼、过海、8 号风球
报价模型术语 基础人工费、楼宇系数、时段系数、供需平衡系数
技术与角色术语 规则引擎、RACI、MVP、C2C 撮合

步骤 4:创建报价服务子目录与设计文档

报价服务是平台首个落地的核心服务,独立建子目录 报价服务/

文件 编号 内容
README.md DOC-P31 报价服务定位、设计原则、文档索引、后续规划
报价模型设计.md DOC-P32 报价公式、八大参数体系、品类费率表、场景示例、费用拆解、场景矩阵、时段定价、动态调价、C2C 过渡、价格透明化、参数速查

报价模型设计基于 市场调研报告第七章,核心公式为:

平台报价 = [(基础人工费 × ∏ 各维系数)+ ∑ 各附加费] × (1 + 平台管理费率)

整合 8 大类参数、32 项细分因子。

步骤 5:创建技术文档子目录

独立建子目录 技术文档/,当前为规划阶段,列出 8 项待编写文档清单(系统总体架构、报价引擎技术方案、楼宇数据库设计等)及技术原则(MVP 优先、规则引擎先行、渐进智能化)。

步骤 6:修正工作日志路径

将工作日志各文件中的 file:/// 绝对路径全部修正为相对路径,确保项目迁移后链接有效。


三、结论与产出

本次对话产出物清单

序号 产出物 位置 状态
1 agents.md V2.0(项目管理制度总纲) docs/agents.md 已完成
2 术语表.md(独立) docs/术语表.md 已完成
3 报价服务 README docs/报价服务/README.md 已完成
4 报价模型设计.md docs/报价服务/报价模型设计.md 已完成
5 技术文档 README docs/技术文档/README.md 已完成
6 工作日志各文件路径修正 docs/工作日志/ 已完成

关键决策与说明

  1. 项目名称确定:通过 OCR 识别品牌 VI 图片中的英文"WEAVELY"及中文艺术字,结合上下文推断并经用户确认品牌中文名为"织布鸟",项目名称为"香港配送+安装互联网平台",运营主体为"织布鸟智居科技有限公司"。
  2. 管理制度建立:agents.md 从入口文档升级为项目管理制度总纲,新增目标/任务/进度/风险/质量/变更/决策/汇报八大管理制度与 RACI 权责矩阵。
  3. Git 规范:使用中国境内 Gitee 服务,轻量 Git Flow 分支策略,提交规范 <类型>: <简述>
  4. 文档独立:术语表从附录独立为术语表.md;报价服务独立子目录含模型设计文档;技术文档独立子目录。
  5. 相对路径:所有文档引用一律相对路径,禁止绝对路径,确保项目迁移有效。

四、待办事项

序号 待办 负责人 截止时间 状态
1 审阅 agents.md V2.0,确认 RACI 角色分配与管理制度 项目发起人 待定 待确认
2 初始化 Git 仓库(Gitee),建立 main/dev 分支 技术负责人 待定 待办
3 启动楼宇数据库设计(报价模型前置依赖) 技术负责人 待定 待办
4 细化 8 大品类 32 细分类目基础费率表 业务负责人 待定 待办
5 编写技术文档规划清单中的各项方案 技术负责人 待定 待办
6 团队成员确认后,补充公司介绍手册(DOC-P21)关键信息 业务负责人 待定 待办

五、备注

  • 本记录由听写根据对话全过程整理,力求如实反映工作过程。
  • 品牌名称识别过程涉及 OCR 技术处理(easyocr 库安装、模型镜像下载),相关脚本存放于系统临时目录。
  • 后续如对项目管理制度或报价模型有调整,须走 变更管理 流程,并新增工作日志记录。