diff --git a/knowledge/README.md b/knowledge/README.md new file mode 100644 index 0000000..5c5b026 --- /dev/null +++ b/knowledge/README.md @@ -0,0 +1,39 @@ +# 知识库索引 + +> 本知识库与 Agent 配置文件解耦,由 COO 主导维护,各领域负责人协作贡献。 +> 通过 `wiki_search` / `memory_search` / `qmd` 等工具检索,人类可通过 Web UI 审查优化。 + +## 目录结构 + +| 目录 | 领域 | 责任人 | 条目数 | +|------|------|--------|--------| +| [电商/](电商/) | 淘宝、抖店、微信小店运营 | 陆云帆 (taobaospecialist) | — | +| [内容/](内容/) | 小红书、短视频、文案 | 文墨言 (contentspecialist) | — | +| [产品/](产品/) | PRD、需求分析 | 沈路明 (productmanager) | — | +| [技术/](技术/) | 开发规范、代码审查 | 徐聪 (costcodev) | — | +| [设计/](设计/) | UI设计、品牌规范 | 苏绘锦 (designer) | — | +| [运营/](运营/) | 活动策划、数据分析 | 陆怀瑾 (coo) | — | +| [行政/](行政/) | 合同、报销流程 | 刘诗妮 (secretary) | — | + +## 知识条目格式 + +每个知识条目遵循 [模板](../templates/知识条目模板.md)。 + +## 检索方式 + +- **Agent 主动查询**:`wiki_search` / `memory_search` / `qmd` +- **人类审查**:通过 Web UI 浏览、编辑、优化 +- **质量检查**:`wiki_lint` 定期运行 + +## 贡献流程 + +1. 领域负责人撰写条目 +2. COO 审核内容质量 +3. 提交到 EnterpriseArchitect 仓库 +4. 通过 `wiki_lint` 检查 +5. 通知相关 Agent 更新索引 + +--- + +**维护者**:陆怀瑾(COO) +**最后更新**:2026-06-22 \ No newline at end of file diff --git a/knowledge/产品/PRD模板.md b/knowledge/产品/PRD模板.md new file mode 100644 index 0000000..09906ac --- /dev/null +++ b/knowledge/产品/PRD模板.md @@ -0,0 +1,111 @@ +# PRD 模板 + +## 元数据 + +| 属性 | 值 | +|------|-----| +| **领域** | 产品 | +| **责任人** | 沈路明 (productmanager) | +| **版本** | v1.0 | +| **创建日期** | 2026-06-22 | +| **标签** | PRD, 产品需求, 模板 | + +## 概述 + +产品需求文档(PRD)标准模板。适用于所有产品功能需求、系统改进需求的规范化描述,确保开发团队、设计团队、业务团队对需求理解一致。 + +## 正文 + +### 一、文档头部 + +``` +# [产品名称] - [功能名称] PRD + +| 属性 | 值 | +|------|-----| +| **版本** | v1.0 | +| **作者** | [姓名] | +| **创建日期** | YYYY-MM-DD | +| **状态** | 草稿 / 评审中 / 已批准 / 已上线 | +| **关联文档** | [链接] | +``` + +### 二、需求概述 + +**2.1 背景与问题** +[描述为什么需要这个功能,解决了什么用户痛点或业务问题] + +**2.2 目标用户** +- 用户画像 1:[描述] +- 用户画像 2:[描述] + +**2.3 核心目标** +- 业务目标:[可量化指标,如转化率提升 X%] +- 用户目标:[用户获得什么价值] +- 技术目标:[如响应时间、并发量] + +### 三、功能描述 + +**3.1 功能范围** +- P0(必须):[最小可用功能] +- P1(应该):[重要但可后续] +- P2(锦上添花):[可后续迭代] + +**3.2 用户故事** + +``` +作为 [用户角色], +我希望 [功能/行为], +以便 [获得的价值/目标]。 +``` + +**3.3 详细交互说明** +1. [步骤1]:[描述 + 原型图链接] +2. [步骤2]:[描述 + 原型图链接] + +**3.4 边界与异常** +- 正常流程:[描述] +- 异常情况1:[触发条件 + 处理方式] +- 异常情况2:[触发条件 + 处理方式] + +### 四、非功能需求 + +| 项目 | 要求 | +|------|------| +| 页面加载 | ≤ 2 秒 | +| 接口响应 | ≤ 500ms | +| 并发支持 | 1000 QPS | +| 兼容性 | iOS 13+, Android 9+, Chrome 90+ | + +### 五、数据埋点 + +| 事件名 | 触发条件 | 属性 | +|--------|----------|------| +| [event_name] | [触发条件] | [上报字段] | + +### 六、验收标准 + +- [ ] 功能1 验收条件 +- [ ] 功能2 验收条件 +- [ ] 非功能需求满足 + +### 七、排期与里程碑 + +| 里程碑 | 日期 | 交付物 | +|--------|------|--------| +| 设计评审 | YYYY-MM-DD | 交互/视觉稿 | +| 技术评审 | YYYY-MM-DD | 技术方案 | +| 开发完成 | YYYY-MM-DD | 可测试版本 | +| 上线 | YYYY-MM-DD | 生产环境 | + +## 相关条目 + +- [需求分析方法.md](需求分析方法.md) +- [开发规范.md](../技术/开发规范.md) +- [UI设计规范.md](../设计/UI设计规范.md) + +## 变更记录 + +| 日期 | 版本 | 变更说明 | 变更人 | +|------|------|----------|--------| +| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 | \ No newline at end of file diff --git a/knowledge/产品/README.md b/knowledge/产品/README.md new file mode 100644 index 0000000..d1386b3 --- /dev/null +++ b/knowledge/产品/README.md @@ -0,0 +1,21 @@ +# 产品领域知识 + +**责任人**:沈路明(productmanager) +**审核人**:陆怀瑾(coo) + +## 知识范围 + +涵盖产品需求文档、用户研究、竞品分析、需求管理、版本规划等产品管理知识。 + +## 条目清单 + +| 文件名 | 说明 | 状态 | +|--------|------|------| +| [PRD模板.md](PRD模板.md) | 产品需求文档标准模板 | ✅ | +| [需求分析方法.md](需求分析方法.md) | 用户需求调研与分析方法 | ✅ | + +## 待建设 + +- 竞品分析框架 +- 产品路线图模板 +- 用户故事编写指南 \ No newline at end of file diff --git a/knowledge/产品/需求分析方法.md b/knowledge/产品/需求分析方法.md new file mode 100644 index 0000000..f482b13 --- /dev/null +++ b/knowledge/产品/需求分析方法.md @@ -0,0 +1,84 @@ +# 需求分析方法 + +## 元数据 + +| 属性 | 值 | +|------|-----| +| **领域** | 产品 | +| **责任人** | 沈路明 (productmanager) | +| **版本** | v1.0 | +| **创建日期** | 2026-06-22 | +| **标签** | 需求分析, 用户调研, 产品管理 | + +## 概述 + +需求分析是从用户/业务痛点出发,将模糊的需求描述转化为可落地的产品功能规格的系统化方法。核心原则:先理解问题,再设计方案。 + +## 正文 + +### 一、需求收集方法 + +1. **用户访谈**(定性) + - 每轮访谈 5-8 个目标用户 + - 半结构化访谈:准备提纲 + 灵活追问 + - 核心问题:「你最想解决什么问题?」「现在怎么解决的?」 + +2. **问卷调查**(定量) + - 覆盖 100+ 目标用户 + - 包含选择题(量化)+ 开放题(发掘) + - 关键指标:问题频率、痛点程度、替代方案满意度 + +3. **数据分析** + - 页面点击热力图 + - 用户行为漏斗(转化率断点) + - 客服工单高频关键词 + +### 二、需求优先级评估 — ICE 模型 + +| 因子 | 说明 | 评分 (1-10) | +|------|------|------------| +| **I**mpact(影响面) | 影响多少用户?对核心指标影响多大? | | +| **C**onfidence(信心度) | 我们有多少证据这个方案有效? | | +| **E**ase(实现难度) | 开发成本多高?时间多长? | | + +总分 = I × C × E(E 分数越高越容易,越大越好) + +### 三、需求文档化 + +1. **用户故事标准格式** + > 作为 **[用户角色]**, + > 我希望 **[功能/行为]**, + > 以便 **[获得的价值]**。 + +2. **验收条件(Acceptance Criteria)** + - 必须可测试、可验证 + - 正面条件 + 边缘情况 + +3. **原型验证** + - 低保真原型验证交互流程(1-2 天) + - 用户测试 3-5 人,观察操作行为 + - 根据反馈迭代后进入高保真设计 + +### 四、需求评审流程 + +``` +需求方提出 → PM 分析评估 → 交互设计 → 技术评审 + → 排期评估 → 最终评审 → 进入开发 +``` + +每一步评审需至少以下人员参与: +- PM(负责人) +- 1 名开发(评估技术可行性) +- 1 名设计师(评估交互可行性) +- 需求方(确认需求理解正确) + +## 相关条目 + +- [PRD模板.md](PRD模板.md) +- [开发规范.md](../技术/开发规范.md) + +## 变更记录 + +| 日期 | 版本 | 变更说明 | 变更人 | +|------|------|----------|--------| +| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 | \ No newline at end of file diff --git a/knowledge/内容/README.md b/knowledge/内容/README.md new file mode 100644 index 0000000..607208f --- /dev/null +++ b/knowledge/内容/README.md @@ -0,0 +1,21 @@ +# 内容领域知识 + +**责任人**:文墨言(contentspecialist) +**审核人**:陆怀瑾(coo) + +## 知识范围 + +涵盖小红书、短视频平台、公众号等内容平台运营知识,包括内容创作、选题策划、标题优化、发布策略、数据分析等。 + +## 条目清单 + +| 文件名 | 说明 | 状态 | +|--------|------|------| +| [小红书运营指南.md](小红书运营指南.md) | 小红书内容运营全流程指南 | ✅ | +| [标题写作技巧.md](标题写作技巧.md) | 爆款标题创作方法论 | ✅ | + +## 待建设 + +- 短视频脚本模板 +- 公众号排版规范 +- 内容日历模板 \ No newline at end of file diff --git a/knowledge/内容/小红书运营指南.md b/knowledge/内容/小红书运营指南.md new file mode 100644 index 0000000..c32fcd7 --- /dev/null +++ b/knowledge/内容/小红书运营指南.md @@ -0,0 +1,82 @@ +# 小红书运营指南 + +## 元数据 + +| 属性 | 值 | +|------|-----| +| **领域** | 内容 | +| **责任人** | 文墨言 (contentspecialist) | +| **版本** | v1.0 | +| **创建日期** | 2026-06-22 | +| **标签** | 小红书, 内容运营, 种草, 涨粉 | + +## 概述 + +小红书是以"真实分享+种草"为核心的内容社区,运营不同于其他平台。核心逻辑:真诚分享 > 硬广推广,封面/标题决定点击率,内容质量决定涨粉转化。 + +## 正文 + +### 一、内容定位与选题 + +1. **账号定位**(上线前必做) + - 明确赛道:美妆/穿搭/家居/母婴/美食/知识 + - 确定人设:专家型/体验型/教程型 + - 对标 3-5 个同赛道 Top 博主 + +2. **选题策略** + - 热点追踪:小红书热搜 + 抖音热点宝 + - 实用内容:教程/清单/测评/避坑 + - 情感共鸣:个人经历/观点分享/生活记录 + +### 二、内容制作标准 + +1. **封面设计**(点击率核心) + - 高饱和度配色,对比度强 + - 简洁文字 3-7 字,避免遮挡主体 + - 尺寸 3:4,首图即为封面 + +2. **标题公式** + - 数字型:「3 步搞定...」 + - 痛点型:「为什么你...还是不行?」 + - 对比型:「A vs B,差距到底在哪」 + - 清单型:「2026 必入的 10 款...」 + +3. **正文结构** + - 开头(3 句):抛痛点/抛结论 + - 主体:分点说明,配图对应 + - 结尾:互动引导(提问/投票/求关注) + +### 三、发布与推广 + +1. **发布时间** + - 工作日:12:00-14:00, 18:00-21:00 + - 周末:10:00-12:00, 15:00-18:00 + +2. **话题标签策略** + - 1-2 个大流量话题(#穿搭 #美妆 #家居) + - 2-3 个精准话题(#小个子穿搭 #通勤穿搭) + - 1 个自创话题(#XX的日常搭配) + +3. **初期冷启动** + - 发布后 1 小时内互动(评论/点赞)对推荐权重影响最大 + - 在同类笔记下真诚评论(非硬广引流) + +### 四、数据指标 + +| 指标 | 新手目标 | 进阶目标 | +|------|----------|----------| +| 单篇阅读量 | 1000+ | 5000+ | +| 点赞率 | 3%+ | 5%+ | +| 收藏率 | 2%+ | 4%+ | +| 涨粉率 | 1%/篇 | 3%/篇 | + +## 相关条目 + +- [标题写作技巧.md](标题写作技巧.md) +- [活动策划模板.md](../运营/活动策划模板.md) + +## 变更记录 + +| 日期 | 版本 | 变更说明 | 变更人 | +|------|------|----------|--------| +| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 | \ No newline at end of file diff --git a/knowledge/技术/README.md b/knowledge/技术/README.md new file mode 100644 index 0000000..c71942c --- /dev/null +++ b/knowledge/技术/README.md @@ -0,0 +1,21 @@ +# 技术领域知识 + +**责任人**:徐聪(costcodev) +**审核人**:陆怀瑾(coo) + +## 知识范围 + +涵盖开发规范、代码审查、架构设计、部署运维、技术选型等技术团队知识。 + +## 条目清单 + +| 文件名 | 说明 | 状态 | +|--------|------|------| +| [开发规范.md](开发规范.md) | 代码编写与项目管理规范 | ✅ | +| [代码审查清单.md](代码审查清单.md) | Pull Request 审查标准 | ✅ | + +## 待建设 + +- API 设计规范 +- 数据库设计指南 +- 技术选型决策框架 \ No newline at end of file diff --git a/knowledge/技术/开发规范.md b/knowledge/技术/开发规范.md new file mode 100644 index 0000000..13d0387 --- /dev/null +++ b/knowledge/技术/开发规范.md @@ -0,0 +1,104 @@ +# 开发规范 + +## 元数据 + +| 属性 | 值 | +|------|-----| +| **领域** | 技术 | +| **责任人** | 徐聪 (costcodev) | +| **版本** | v1.0 | +| **创建日期** | 2026-06-22 | +| **标签** | 开发规范, 代码风格, Git, 项目管理 | + +## 概述 + +定义团队统一的代码编写、项目管理、协作流程规范。目的是确保代码可维护、可交接,降低协作摩擦。 + +## 正文 + +### 一、代码规范 + +1. **Python** + - 遵循 PEP 8 代码风格 + - 使用 `black` 自动格式化,行宽 100 + - 类型注解必须(`mypy --strict` 通过) + - 文档字符串用 Google 风格 + +2. **TypeScript/JavaScript** + - 使用 `prettier` 格式化 + - ESLint 严格模式 + - 禁止 `any` 类型(除非显式标注 `// eslint-disable-next-line`) + - 所有公共 API 必须有 JSDoc + +3. **通用规则** + - 函数单一职责,不超过 50 行 + - 命名:camelCase(变量/函数)、PascalCase(类/组件)、UPPER_SNAKE(常量) + - 禁止 `print` / `console.log` 残留(用日志库) + - 禁止注释掉的代码(相信 Git) + +### 二、Git 规范 + +1. **分支策略** + ``` + main ─── 生产环境 + develop ─── 开发主线 + feature/- ─── 功能分支 + fix/- ─── 修复分支 + ``` + +2. **Commit 格式** + ``` + (): + + + +