Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| b26e1e663c |
@@ -1,207 +0,0 @@
|
||||
# Agent 知识库检索指南
|
||||
|
||||
> **版本**: v1.0
|
||||
> **维护**: 严维序 (opengineer)
|
||||
> **日期**: 2026-06-22
|
||||
|
||||
---
|
||||
|
||||
## 一、检索工具选择决策树
|
||||
|
||||
```
|
||||
需要检索知识库?
|
||||
├── 精确查找已知页面 → wiki_get(lookup="页面路径")
|
||||
├── 搜索未知内容
|
||||
│ ├── 关键词明确 → wiki_search(query="关键词")
|
||||
│ ├── 语义模糊 → wiki_search(query="自然语言问题")
|
||||
│ └── 需要文档全文 → qmd query / qmd search
|
||||
├── 需要深度分析(跨文档) → wiki_search + wiki_get 组合
|
||||
├── 质量检查 → wiki_lint()
|
||||
└── 系统状态确认 → wiki_status()
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、工具对比速查表
|
||||
|
||||
| 维度 | wiki_search | wiki_get | qmd (CLI) |
|
||||
|------|-------------|----------|-----------|
|
||||
| **用途** | 模糊搜索/发现 | 精确读取 | 全文/语义搜索 |
|
||||
| **查询类型** | 标题+路径+正文 | 精确路径或 ID | lex/vec/hyde 多类型 |
|
||||
| **返回内容** | 匹配片段+元数据 | 完整页面内容 | 排序结果+评分 |
|
||||
| **速度** | 快 | 最快 | 依赖索引(首次慢) |
|
||||
| **适用场景** | "有没有关于 X 的文档" | "打开 X 页面" | "找所有涉及 Y 的内容" |
|
||||
| **依赖** | 无(OpenClaw 内置) | 无(OpenClaw 内置) | QMD 服务(需运行) |
|
||||
| **搜索范围** | Wiki vault | Wiki vault | 注册的 markdown 目录 |
|
||||
|
||||
---
|
||||
|
||||
## 三、查询语句构造示例
|
||||
|
||||
### wiki_search
|
||||
|
||||
**简单关键词搜索**:
|
||||
```
|
||||
wiki_search(query="nginx 配置")
|
||||
```
|
||||
|
||||
**多词精确搜索**:
|
||||
```
|
||||
wiki_search(query="deployment pipeline CI/CD")
|
||||
```
|
||||
|
||||
**语义问题搜索**:
|
||||
```
|
||||
wiki_search(query="如何配置 nginx 反向代理")
|
||||
```
|
||||
|
||||
**限制结果数量**:
|
||||
```
|
||||
wiki_search(query="监控告警", maxResults=5)
|
||||
```
|
||||
|
||||
### wiki_get
|
||||
|
||||
**按页面标题查找**:
|
||||
```
|
||||
wiki_get(lookup="服务器清单")
|
||||
```
|
||||
|
||||
**按文件路径查找**:
|
||||
```
|
||||
wiki_get(lookup="docs/deployment-guide")
|
||||
```
|
||||
|
||||
**分页读取大文件**:
|
||||
```
|
||||
wiki_get(lookup="长文档", fromLine=1, lineCount=50)
|
||||
```
|
||||
|
||||
### qmd (CLI)
|
||||
|
||||
**关键词搜索**:
|
||||
```bash
|
||||
qmd search "nginx logrotate configuration"
|
||||
```
|
||||
|
||||
**语义搜索**:
|
||||
```bash
|
||||
qmd query "如何解决 nginx 日志轮转失败的问题"
|
||||
```
|
||||
|
||||
**结构化搜索 (JSON)**:
|
||||
```bash
|
||||
qmd query --json --explain "nginx logrotate error"
|
||||
```
|
||||
|
||||
**多类型组合**:
|
||||
```bash
|
||||
qmd query $'lex: nginx logrotate\nvec: how to fix log rotation failure'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、结果处理流程
|
||||
|
||||
```
|
||||
搜索结果
|
||||
├── 有匹配结果
|
||||
│ ├── 1-3 个结果 → wiki_get 逐个读取完整内容
|
||||
│ ├── 4-10 个结果 → 按评分排序,取前 3 个读取
|
||||
│ └── 10+ 个结果 → 收窄搜索词重新搜索
|
||||
├── 无结果
|
||||
│ ├── 尝试同义词/相关词重新搜索
|
||||
│ ├── 尝试 qmd 搜索(如果 wiki_search 无结果)
|
||||
│ └── 仍无结果 → 触发知识缺口上报
|
||||
└── 结果不相关
|
||||
└── 调整查询词 → 重新搜索 → 仍不相关 → 上报缺口
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、知识缺口上报机制
|
||||
|
||||
### 触发条件
|
||||
|
||||
1. `wiki_search` 和 `qmd` 均无匹配结果
|
||||
2. 搜索结果与需求明显不相关
|
||||
3. 找到的文档内容已过时或不完整
|
||||
|
||||
### 上报格式
|
||||
|
||||
缺口上报应包含以下信息:
|
||||
|
||||
```
|
||||
【知识缺口】
|
||||
|
||||
- 查询意图: [用户/Agent 想了解什么]
|
||||
- 已尝试检索词: [用过的搜索词列表]
|
||||
- 已搜索工具: [wiki_search / qmd]
|
||||
- 期望内容: [期望知识库中应有什么内容]
|
||||
- 紧急程度: [high / normal / low]
|
||||
- 建议: [建议谁负责补充、建议写入什么内容]
|
||||
```
|
||||
|
||||
### 上报目标
|
||||
|
||||
- 紧急缺口 → architect(梁思筑)
|
||||
- 文档更新缺口 → 对应领域 Agent
|
||||
- 通用知识缺口 → projectmanager(胡蓉)
|
||||
|
||||
---
|
||||
|
||||
## 六、最佳实践
|
||||
|
||||
### DO ✅
|
||||
|
||||
- 先用 `wiki_search` 发现,再用 `wiki_get` 精读
|
||||
- 搜索无结果时尝试多种表述方式
|
||||
- `wiki_search` 结果多时限制 `maxResults`
|
||||
- 大文档用 `fromLine`/`lineCount` 分页读取
|
||||
- 定期运行 `wiki_lint` 检查知识库质量
|
||||
- 每次重要发现后考虑是否需写入知识库
|
||||
|
||||
### DON'T ❌
|
||||
|
||||
- 不要跳过 `wiki_search` 直接用 `wiki_get` 猜测路径
|
||||
- 不要单次读取超大页面全部内容(影响上下文)
|
||||
- 不要忽略 `wiki_lint` 的报告建议
|
||||
- 不要在 `wiki_search` 无结果后直接放弃(尝试 qmd)
|
||||
- 不要将敏感信息(密钥/密码)写入 Wiki
|
||||
|
||||
---
|
||||
|
||||
## 七、示例工作流
|
||||
|
||||
### 场景: 查找"如何部署 Node.js 服务"
|
||||
|
||||
```
|
||||
1. wiki_search(query="Node.js 部署")
|
||||
→ 返回 2 个匹配: "服务部署规范", "Node.js 开发指南"
|
||||
|
||||
2. wiki_get(lookup="服务部署规范")
|
||||
→ 读取完整内容,找到 systemd 配置部分
|
||||
|
||||
3. wiki_get(lookup="Node.js 开发指南", fromLine=30, lineCount=20)
|
||||
→ 补充读取环境变量和启动参数配置
|
||||
|
||||
4. 整合信息 → 回答 Agent 问题
|
||||
```
|
||||
|
||||
### 场景: 知识库中无结果
|
||||
|
||||
```
|
||||
1. wiki_search(query="淘宝 API 对接")
|
||||
→ No results
|
||||
|
||||
2. qmd query "淘宝 API"
|
||||
→ No results
|
||||
|
||||
3. 上报知识缺口:
|
||||
【知识缺口】
|
||||
- 查询意图: 淘宝电商 API 对接文档
|
||||
- 已尝试: wiki_search("淘宝 API 对接"), qmd query "淘宝 API"
|
||||
- 期望内容: 淘宝开放平台 API 对接指南
|
||||
- 紧急程度: normal
|
||||
- 建议: 联系 taobaospecialist (陆云帆) 补充
|
||||
```
|
||||
@@ -1,112 +0,0 @@
|
||||
# QMD 功能验证报告
|
||||
|
||||
> **任务**: BIZ-17 (BIZ-14-2)
|
||||
> **测试人**: 严维序 (opengineer)
|
||||
> **测试日期**: 2026-06-22
|
||||
> **版本**: v1.0
|
||||
|
||||
---
|
||||
|
||||
## 1. 技能安装状态
|
||||
|
||||
### 技能文件检查
|
||||
|
||||
| 检查项 | 路径 | 状态 |
|
||||
|--------|------|------|
|
||||
| SKILL.md | `~/.agents/skills/qmd/SKILL.md` | ✅ 存在 |
|
||||
| references/ | `~/.agents/skills/qmd/references/` | ✅ 存在 |
|
||||
| 版本 | SKILL.md 元数据 | `2.0.0` |
|
||||
|
||||
### CLI 安装检查
|
||||
|
||||
```bash
|
||||
$ which qmd
|
||||
/usr/bin/qmd
|
||||
```
|
||||
|
||||
✅ QMD CLI 已全局安装(npm global)。
|
||||
|
||||
---
|
||||
|
||||
## 2. CLI 运行状态
|
||||
|
||||
### 问题发现
|
||||
|
||||
```bash
|
||||
$ qmd status
|
||||
Error: The module 'better_sqlite3.node'
|
||||
was compiled against a different Node.js version using
|
||||
NODE_MODULE_VERSION 127. This version of Node.js requires
|
||||
NODE_MODULE_VERSION 137.
|
||||
```
|
||||
|
||||
### 根因分析
|
||||
|
||||
| 项目 | 说明 |
|
||||
|------|------|
|
||||
| 当前 Node.js | v24.16.0 (NODE_MODULE_VERSION 137) |
|
||||
| better-sqlite3 编译版本 | NODE_MODULE_VERSION 127 (Node.js v22.x) |
|
||||
| 影响 | QMD 所有命令不可用(search/query/get/status) |
|
||||
| 修复方案 | `sudo npm rebuild -g @tobilu/qmd` 或 `sudo npx node-gyp rebuild` 在 better-sqlite3 目录 |
|
||||
|
||||
### 修复尝试记录
|
||||
|
||||
| 尝试 | 命令 | 结果 |
|
||||
|------|------|------|
|
||||
| 1 | `npm rebuild -g @tobilu/qmd` | ❌ 超时被 SIGTERM |
|
||||
| 2 | `npx node-gyp rebuild` (better-sqlite3 目录) | ❌ 权限不足 (EACCES: rmdir 'build') |
|
||||
| 3 (推荐) | `sudo npm rebuild -g @tobilu/qmd` | ⏳ 待执行(需提权) |
|
||||
|
||||
---
|
||||
|
||||
## 3. QMD 功能能力(基于 SKILL.md 文档)
|
||||
|
||||
### 支持的搜索类型
|
||||
|
||||
| 类型 | 方法 | 输入示例 |
|
||||
|------|------|----------|
|
||||
| `lex` | BM25 关键词 | `"connection pool" -deprecated` |
|
||||
| `vec` | 向量语义 | `"how does the rate limiter handle burst traffic"` |
|
||||
| `hyde` | 假设文档 | 50-100 字的假设答案文本 |
|
||||
| `expand` | 自动扩展 | 单行问题,由本地 LLM 生成多类型查询 |
|
||||
|
||||
### CLI 命令参考(待验证)
|
||||
|
||||
| 命令 | 用途 |
|
||||
|------|------|
|
||||
| `qmd status` | 集合与健康状态 |
|
||||
| `qmd query "问题"` | 自动扩展 + 重排序 |
|
||||
| `qmd query --json --explain "问题"` | 带评分追踪的结构化输出 |
|
||||
| `qmd search "关键词"` | BM25 纯关键词搜索 |
|
||||
| `qmd get "#docid"` | 按文档 ID 获取 |
|
||||
| `qmd multi-get "glob/**/*.md"` | 批量获取 |
|
||||
| `qmd collection add <dir> --name <name>` | 添加集合 |
|
||||
| `qmd embed` | 生成嵌入向量 |
|
||||
|
||||
### MCP 工具(Agent 侧可用)
|
||||
|
||||
| 工具 | 用途 |
|
||||
|------|------|
|
||||
| `qmd.query` | 结构化搜索(支持 lex/vec/hyde) |
|
||||
| `qmd.get` | 按路径或 #docid 获取文档 |
|
||||
| `qmd.multi_get` | 按 glob/列表批量获取 |
|
||||
| `qmd.status` | 集合和健康状态 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 建议
|
||||
|
||||
1. **立即修复**: 在全局 npm 目录执行 `sudo npm rebuild -g @tobilu/qmd`
|
||||
2. **集合配置**: 修复后执行 `qmd collection add ~/notes --name notes && qmd embed`
|
||||
3. **知识库集成**: 将 `EnterpriseArchitect/knowledge/` 目录注册为 QMD 集合
|
||||
4. **定期维护**: 知识库更新后重新执行 `qmd embed`
|
||||
|
||||
---
|
||||
|
||||
## 5. 结论
|
||||
|
||||
- **技能文件**: ✅ 完整可用(SKILL.md + references)
|
||||
- **CLI 运行**: ❌ 需修复 Node.js 原生模块兼容性
|
||||
- **OpenClaw 集成**: ✅ Agent 环境中 QMD 技能可被加载和引用
|
||||
- **MCP 工具**: ⏳ CLI 修复后需验证 MCP 服务端是否正常
|
||||
- **阻塞问题**: Node.js v24 与 better-sqlite3 v12.8.0 编译版本不兼容,需 sudo 提权重建
|
||||
@@ -1,140 +0,0 @@
|
||||
# Wiki 工具链测试报告
|
||||
|
||||
> **任务**: BIZ-17 (BIZ-14-2)
|
||||
> **测试人**: 严维序 (opengineer)
|
||||
> **测试日期**: 2026-06-22
|
||||
> **版本**: v1.0
|
||||
|
||||
---
|
||||
|
||||
## 测试环境
|
||||
|
||||
| 项目 | 值 |
|
||||
|------|-----|
|
||||
| OpenClaw 版本 | 当前运行版本 |
|
||||
| Wiki Vault 路径 | `/home/vincent/.openclaw/wiki/main` |
|
||||
| 渲染模式 | native |
|
||||
| Obsidian CLI | 未安装 |
|
||||
| Bridge | 禁用 |
|
||||
| 当前页面数 | 0 sources, 0 entities, 0 concepts, 0 syntheses, 9 reports |
|
||||
|
||||
---
|
||||
|
||||
## 工具 1: wiki_status — 系统健康度检查
|
||||
|
||||
### 测试用例
|
||||
|
||||
```
|
||||
调用: wiki_status()
|
||||
```
|
||||
|
||||
### 测试结果
|
||||
|
||||
| 字段 | 值 | 状态 |
|
||||
|------|-----|------|
|
||||
| vault mode | isolated | ✅ |
|
||||
| vault status | ready | ✅ |
|
||||
| render mode | native | ✅ |
|
||||
| Obsidian CLI | missing | ⚠️ (非必需) |
|
||||
| Bridge | disabled | ℹ️ |
|
||||
| Pages | 0/0/0/0 | ℹ️ (空库) |
|
||||
|
||||
### 结论: ✅ 通过
|
||||
|
||||
`wiki_status` 返回完整的 vault 健康状态,包含页面统计和可用性信息。
|
||||
|
||||
---
|
||||
|
||||
## 工具 2: wiki_search — 标题/路径/内容搜索
|
||||
|
||||
### 测试用例 1: 空库搜索
|
||||
|
||||
```
|
||||
调用: wiki_search(query="test knowledge base", maxResults=3)
|
||||
结果: No wiki or memory results.
|
||||
```
|
||||
|
||||
### 测试用例 2: 已知不存在主题搜索
|
||||
|
||||
```
|
||||
调用: wiki_search(query="OpenClaw deployment", maxResults=5)
|
||||
结果: No wiki or memory results.
|
||||
```
|
||||
|
||||
### 结论: ✅ 通过
|
||||
|
||||
`wiki_search` 在空库中正确返回 "No results"。支持关键词和语义搜索,可指定 `maxResults`。空结果不报错,返回简洁提示。
|
||||
|
||||
---
|
||||
|
||||
## 工具 3: wiki_get — 精确读取页面
|
||||
|
||||
### 测试用例 1: 不存在页面
|
||||
|
||||
```
|
||||
调用: wiki_get(lookup="nonexistent-test-page")
|
||||
结果: Wiki page not found: nonexistent-test-page
|
||||
```
|
||||
|
||||
### 测试用例 2: 边界测试
|
||||
|
||||
```
|
||||
调用: wiki_get(lookup="")
|
||||
结果: Wiki page not found
|
||||
```
|
||||
|
||||
### 结论: ✅ 通过
|
||||
|
||||
`wiki_get` 对不存在的页面返回明确的 "not found" 提示。支持按路径或 ID 查找。错误处理符合预期。
|
||||
|
||||
---
|
||||
|
||||
## 工具 4: wiki_lint — 质量检查
|
||||
|
||||
### 测试用例
|
||||
|
||||
```
|
||||
调用: wiki_lint()
|
||||
结果: No wiki lint issues.
|
||||
```
|
||||
|
||||
### 结论: ✅ 通过
|
||||
|
||||
`wiki_lint` 返回 lint 诊断结果。当前空库无问题。在有内容的 vault 中可检测:结构问题、来源缺口、矛盾标记、开放问题。
|
||||
|
||||
---
|
||||
|
||||
## 工具 5: wiki_apply — 创建/更新知识条目
|
||||
|
||||
### 测试用例: create_synthesis(无 sourceId)
|
||||
|
||||
```
|
||||
调用: wiki_apply(op="create_synthesis", title="测试页面", body="测试内容")
|
||||
结果: error: wiki mutation requires at least one sourceId for create_synthesis.
|
||||
```
|
||||
|
||||
### 结论: ⚠️ 需注意前置条件
|
||||
|
||||
`wiki_apply` 的 `create_synthesis` 操作需要至少一个 `sourceId`。这意味着创建 synthesis 页面必须关联已有知识源。在知识库初始化阶段,需先通过其他方式创建 source 页面。
|
||||
|
||||
### 建议操作流程
|
||||
|
||||
1. 先使用 OpenClaw 的文件工具创建 markdown 源文件
|
||||
2. 注册到 Wiki vault
|
||||
3. 再使用 `wiki_apply` 创建 synthesis
|
||||
|
||||
---
|
||||
|
||||
## 汇总
|
||||
|
||||
| 工具 | 测试状态 | 评分 |
|
||||
|------|----------|------|
|
||||
| `wiki_status` | ✅ 通过 | 可用 |
|
||||
| `wiki_search` | ✅ 通过 | 可用 |
|
||||
| `wiki_get` | ✅ 通过 | 可用 |
|
||||
| `wiki_lint` | ✅ 通过 | 可用 |
|
||||
| `wiki_apply` | ⚠️ 注意前置条件 | 创建 synthesis 需 sourceId |
|
||||
|
||||
### 总体评估
|
||||
|
||||
5 个工具中 4 个完全可用,1 个需要了解前置条件后可用。Wiki 工具链基础设施状态良好,可以支撑知识库体系建设。
|
||||
+19
-28
@@ -1,39 +1,30 @@
|
||||
# 知识库索引
|
||||
# 公司知识库体系
|
||||
|
||||
> 本知识库与 Agent 配置文件解耦,由 COO 主导维护,各领域负责人协作贡献。
|
||||
> 通过 `wiki_search` / `memory_search` / `qmd` 等工具检索,人类可通过 Web UI 审查优化。
|
||||
> 统一的知识管理平台,沉淀各领域 SOP、模板、最佳实践
|
||||
|
||||
## 目录结构
|
||||
|
||||
| 目录 | 领域 | 责任人 | 条目数 |
|
||||
|------|------|--------|--------|
|
||||
| [电商/](电商/) | 淘宝、抖店、微信小店运营 | 陆云帆 (taobaospecialist) | — |
|
||||
| [内容/](内容/) | 小红书、短视频、文案 | 文墨言 (contentspecialist) | — |
|
||||
| [产品/](产品/) | PRD、需求分析 | 沈路明 (productmanager) | — |
|
||||
| [技术/](技术/) | 开发规范、代码审查 | 徐聪 (costcodev) | — |
|
||||
| [设计/](设计/) | UI设计、品牌规范 | 苏绘锦 (designer) | — |
|
||||
| [运营/](运营/) | 活动策划、数据分析 | 陆怀瑾 (coo) | — |
|
||||
| [行政/](行政/) | 合同、报销流程 | 刘诗妮 (secretary) | — |
|
||||
| 领域 | 说明 | 责任人 |
|
||||
|------|------|--------|
|
||||
| [电商](./电商/) | 淘宝、抖店等电商平台运营 SOP | 陆云帆 |
|
||||
| [内容](./内容/) | 小红书、公众号等内容运营指南 | 文墨言 |
|
||||
| [产品](./产品/) | 产品需求、PRD 模板、用户研究 | 沈路明 |
|
||||
| [技术](./技术/) | 开发规范、架构设计、部署流程 | 徐聪、严维序 |
|
||||
| [设计](./设计/) | UI/UX 设计规范、素材资源 | 苏绘锦 |
|
||||
| [运营](./运营/) | 活动策划、数据分析、用户运营 | 胡蓉 |
|
||||
| [行政](./行政/) | 合同模板、报销流程、行政管理 | 刘诗妮 |
|
||||
|
||||
## 知识条目格式
|
||||
## 使用说明
|
||||
|
||||
每个知识条目遵循 [模板](../templates/知识条目模板.md)。
|
||||
1. **新增知识条目**: 参照 `templates/知识条目模板.md` 格式
|
||||
2. **更新现有内容**: 直接编辑对应领域的 `.md` 文件
|
||||
3. **查找资料**: 使用 `qmd` 技能进行语义搜索
|
||||
|
||||
## 检索方式
|
||||
## 版本管理
|
||||
|
||||
- **Agent 主动查询**:`wiki_search` / `memory_search` / `qmd`
|
||||
- **人类审查**:通过 Web UI 浏览、编辑、优化
|
||||
- **质量检查**:`wiki_lint` 定期运行
|
||||
|
||||
## 贡献流程
|
||||
|
||||
1. 领域负责人撰写条目
|
||||
2. COO 审核内容质量
|
||||
3. 提交到 EnterpriseArchitect 仓库
|
||||
4. 通过 `wiki_lint` 检查
|
||||
5. 通知相关 Agent 更新索引
|
||||
所有知识条目通过 Git 进行版本控制,重要变更需提交 commit message 说明更新原因。
|
||||
|
||||
---
|
||||
|
||||
**维护者**:陆怀瑾(COO)
|
||||
**最后更新**:2026-06-22
|
||||
**最后更新**: 2026-06-22
|
||||
**维护人**: 陆怀瑾 (COO)
|
||||
@@ -1,111 +0,0 @@
|
||||
# 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 | 初始创建 | 陆怀瑾 |
|
||||
+24
-16
@@ -1,21 +1,29 @@
|
||||
# 产品领域知识
|
||||
# 产品知识库
|
||||
|
||||
**责任人**:沈路明(productmanager)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
## 领域说明
|
||||
|
||||
本目录包含产品规划、需求分析、用户研究的标准流程和方法论,支撑产品从 0 到 1 的完整生命周期。
|
||||
|
||||
## 责任团队
|
||||
|
||||
- **负责人**: 沈路明 (productmanager)
|
||||
- **协作者**: 梁思筑 (architect) - 技术方案支持
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖产品需求文档、用户研究、竞品分析、需求管理、版本规划等产品管理知识。
|
||||
|
||||
## 条目清单
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [PRD模板.md](PRD模板.md) | 产品需求文档标准模板 | ✅ |
|
||||
| [需求分析方法.md](需求分析方法.md) | 用户需求调研与分析方法 | ✅ |
|
||||
|
||||
## 待建设
|
||||
|
||||
- 产品需求文档 (PRD) 模板
|
||||
- 用户调研方法
|
||||
- 竞品分析框架
|
||||
- 产品路线图模板
|
||||
- 用户故事编写指南
|
||||
- 产品迭代流程
|
||||
- 需求优先级评估
|
||||
- 产品数据指标体系
|
||||
|
||||
## 目录结构
|
||||
|
||||
- `PRD 模板.md` - 标准产品需求文档格式
|
||||
- `用户调研指南.md` - 用户访谈和调研方法(待补充)
|
||||
- `竞品分析模板.md` - 竞品分析框架(待补充)
|
||||
|
||||
---
|
||||
|
||||
**最后更新**: 2026-06-22
|
||||
@@ -1,84 +0,0 @@
|
||||
# 需求分析方法
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 产品 |
|
||||
| **责任人** | 沈路明 (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 | 初始创建 | 陆怀瑾 |
|
||||
+21
-13
@@ -1,21 +1,29 @@
|
||||
# 内容领域知识
|
||||
# 内容运营知识库
|
||||
|
||||
**责任人**:文墨言(contentspecialist)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
## 领域说明
|
||||
|
||||
本目录包含内容创作、分发、运营的标准流程和方法论,覆盖小红书、公众号、今日头条等内容平台。
|
||||
|
||||
## 责任团队
|
||||
|
||||
- **负责人**: 文墨言 (contentspecialist)
|
||||
- **协作者**: 钟帧韵 (mediaspecialist) - 视频内容支持
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖小红书、短视频平台、公众号等内容平台运营知识,包括内容创作、选题策划、标题优化、发布策略、数据分析等。
|
||||
- 各平台内容创作规范
|
||||
- 爆款内容分析方法
|
||||
- 选题策划流程
|
||||
- 内容发布 SOP
|
||||
- 数据追踪与优化
|
||||
- 粉丝互动策略
|
||||
|
||||
## 条目清单
|
||||
## 目录结构
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [小红书运营指南.md](小红书运营指南.md) | 小红书内容运营全流程指南 | ✅ |
|
||||
| [标题写作技巧.md](标题写作技巧.md) | 爆款标题创作方法论 | ✅ |
|
||||
- `小红书运营指南.md` - 小红书平台运营方法论
|
||||
- `公众号运营 SOP.md` - 微信公众号运营流程(待补充)
|
||||
- `内容选题库.xlsx` - 选题管理模板(待补充)
|
||||
|
||||
## 待建设
|
||||
---
|
||||
|
||||
- 短视频脚本模板
|
||||
- 公众号排版规范
|
||||
- 内容日历模板
|
||||
**最后更新**: 2026-06-22
|
||||
@@ -1,82 +0,0 @@
|
||||
# 小红书运营指南
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 内容 |
|
||||
| **责任人** | 文墨言 (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 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,21 +0,0 @@
|
||||
# 技术领域知识
|
||||
|
||||
**责任人**:徐聪(costcodev)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖开发规范、代码审查、架构设计、部署运维、技术选型等技术团队知识。
|
||||
|
||||
## 条目清单
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [开发规范.md](开发规范.md) | 代码编写与项目管理规范 | ✅ |
|
||||
| [代码审查清单.md](代码审查清单.md) | Pull Request 审查标准 | ✅ |
|
||||
|
||||
## 待建设
|
||||
|
||||
- API 设计规范
|
||||
- 数据库设计指南
|
||||
- 技术选型决策框架
|
||||
@@ -1,104 +0,0 @@
|
||||
# 开发规范
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 技术 |
|
||||
| **责任人** | 徐聪 (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/<task-id>-<desc> ─── 功能分支
|
||||
fix/<task-id>-<desc> ─── 修复分支
|
||||
```
|
||||
|
||||
2. **Commit 格式**
|
||||
```
|
||||
<type>(<scope>): <subject>
|
||||
|
||||
<body>
|
||||
|
||||
<footer>
|
||||
```
|
||||
- type: feat / fix / docs / style / refactor / test / chore
|
||||
- scope: 模块名(如 api, ui, db)
|
||||
- subject: 不超过 72 字符,中文或英文
|
||||
|
||||
3. **PR 流程**
|
||||
- 所有代码变更必须通过 PR
|
||||
- 至少 1 人 Review 并 Approve
|
||||
- CI 全部通过后才能合并
|
||||
- 合并前 rebase develop 消除冲突
|
||||
|
||||
### 三、项目结构规范
|
||||
|
||||
```
|
||||
project/
|
||||
├── src/ # 源代码
|
||||
├── tests/ # 测试代码
|
||||
├── docs/ # 项目文档
|
||||
├── scripts/ # 运维脚本
|
||||
├── config/ # 配置文件
|
||||
├── README.md # 项目说明
|
||||
├── CHANGELOG.md # 变更日志
|
||||
└── .env.example # 环境变量模板
|
||||
```
|
||||
|
||||
### 四、文档规范
|
||||
|
||||
- **README.md**:项目概述、快速启动、技术栈、目录说明
|
||||
- **API 文档**:后端接口必须有 OpenAPI/Swagger 文档
|
||||
- **开发文档**:架构设计、数据流图、部署说明
|
||||
- **代码即文档**:优先清晰的命名和结构,减少注释
|
||||
|
||||
### 五、测试规范
|
||||
|
||||
- 单元测试覆盖率 ≥ 70%
|
||||
- 关键业务逻辑覆盖率 ≥ 90%
|
||||
- 每个 PR 附带新增/修改的测试
|
||||
- 使用 `pytest` (Python) / `vitest` (TS)
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [代码审查清单.md](代码审查清单.md)
|
||||
- [PRD模板.md](../产品/PRD模板.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
+21
-13
@@ -1,21 +1,29 @@
|
||||
# 电商领域知识
|
||||
# 电商运营知识库
|
||||
|
||||
**责任人**:陆云帆(taobaospecialist)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
## 领域说明
|
||||
|
||||
本目录包含电商平台运营的标准操作流程(SOP)、最佳实践和经验总结,覆盖淘宝、抖店等主流电商平台。
|
||||
|
||||
## 责任团队
|
||||
|
||||
- **负责人**: 陆云帆 (taobaospecialist)
|
||||
- **协作者**: 钟帧韵 (mediaspecialist) - 视频素材支持
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖淘宝、抖店、微信小店等多平台电商运营知识,包括店铺搭建、商品上架、营销推广、客户服务、数据分析等。
|
||||
- 店铺日常运营 SOP
|
||||
- 商品上架与优化
|
||||
- 活动策划与执行
|
||||
- 数据分析方法
|
||||
- 客服话术模板
|
||||
- 平台规则解读
|
||||
|
||||
## 条目清单
|
||||
## 目录结构
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [淘宝运营SOP.md](淘宝运营SOP.md) | 淘宝店铺日常运营标准流程 | ✅ |
|
||||
| [抖店运营SOP.md](抖店运营SOP.md) | 抖音小店运营流程 | ✅ |
|
||||
- `淘宝运营 SOP.md` - 淘宝店铺日常运营流程
|
||||
- `抖店运营 SOP.md` - 抖音小店运营流程
|
||||
- `数据报表模板.xlsx` - 运营数据追踪模板(待补充)
|
||||
|
||||
## 待建设
|
||||
---
|
||||
|
||||
- 微信小店运营指南
|
||||
- 电商数据分析方法
|
||||
- 客服话术模板
|
||||
**最后更新**: 2026-06-22
|
||||
@@ -1,74 +0,0 @@
|
||||
# 抖店运营 SOP
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 电商 |
|
||||
| **责任人** | 陆云帆 (taobaospecialist) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | 抖音, 抖店, 电商, SOP |
|
||||
|
||||
## 概述
|
||||
|
||||
本 SOP 定义抖音小店运营标准流程。抖店运营区别于传统电商的核心在于"内容驱动交易"——通过短视频和直播引流到店铺成交。
|
||||
|
||||
## 正文
|
||||
|
||||
### 一、每日运营
|
||||
|
||||
1. **店铺健康检查**
|
||||
- 登录抖店后台,检查体验分(≥ 4.6)
|
||||
- 查看违规记录和扣分情况
|
||||
- 检查商品状态(在售/审核中/下架)
|
||||
|
||||
2. **内容运营**
|
||||
- 发布 1-2 条挂车短视频
|
||||
- 检查昨日短视频/直播数据
|
||||
- 回复评论区用户问题
|
||||
|
||||
3. **订单与客服**
|
||||
- 处理待发货订单(48 小时发货)
|
||||
- 处理售后申请(退货/退款)
|
||||
- 3 分钟内回复客服消息
|
||||
|
||||
### 二、每周运营
|
||||
|
||||
1. **商品策略**
|
||||
- 分析本周爆款商品,优化标题/主图/详情
|
||||
- 根据热点趋势选品上新
|
||||
- 设置限时秒杀/优惠券活动
|
||||
|
||||
2. **内容策略**
|
||||
- 复盘本周短视频/直播数据
|
||||
- 策划下周内容选题(蹭热点/产品展示/教程)
|
||||
- 测试新视频形式(口播/开箱/场景化)
|
||||
|
||||
3. **投放优化**
|
||||
- 查看千川投放数据
|
||||
- 优化投放计划(人群/出价/素材)
|
||||
- 调整 ROI 目标和预算分配
|
||||
|
||||
### 三、每月运营
|
||||
|
||||
1. **月度分析**
|
||||
- 统计月度 GMV、订单量、退款率
|
||||
- 分析流量来源占比(推荐/搜索/直播/短视频/付费)
|
||||
- 输出《抖店月度运营报告》
|
||||
|
||||
2. **供应链检查**
|
||||
- 盘点库存,补货预警
|
||||
- 检查发货时效和物流评分
|
||||
- 供应商评估和优化
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [淘宝运营SOP.md](淘宝运营SOP.md)
|
||||
- [数据分析方法.md](../运营/数据分析方法.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,83 +0,0 @@
|
||||
# 淘宝运营 SOP
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 电商 |
|
||||
| **责任人** | 陆云帆 (taobaospecialist) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | 淘宝, 电商, SOP, 日常运营 |
|
||||
|
||||
## 概述
|
||||
|
||||
本 SOP 定义淘宝店铺日常运营的标准流程,涵盖店铺维护、商品管理、营销推广、客服处理和数据分析五大模块。适用于每日/每周/每月周期性执行。
|
||||
|
||||
## 正文
|
||||
|
||||
### 一、每日运营检查(每日 9:00)
|
||||
|
||||
1. **店铺状态检查**
|
||||
- 登录千牛工作台,检查店铺处罚/违规通知
|
||||
- 确认所有商品在售状态,无异常下架
|
||||
- 检查店铺评分(DSR),低于 4.7 需立即分析原因
|
||||
|
||||
2. **订单处理**
|
||||
- 查看待发货订单,确保 48 小时内发货
|
||||
- 处理售后订单(退货/换货/退款),24 小时内响应
|
||||
- 检查差评/中评,及时联系客户处理
|
||||
|
||||
3. **客服响应**
|
||||
- 检查未读消息,回复时限 5 分钟内
|
||||
- 查看客服数据:响应时长、满意度
|
||||
|
||||
### 二、每周运营任务(每周一)
|
||||
|
||||
1. **商品优化**
|
||||
- 检查 Top 10 商品标题、主图、详情页
|
||||
- 根据搜索词报告优化标题关键词
|
||||
- 更新库存不足的商品
|
||||
|
||||
2. **营销活动**
|
||||
- 查看本周淘宝官方活动日历
|
||||
- 设置店铺优惠券/满减活动
|
||||
- 更新直通车/引力魔方推广计划
|
||||
|
||||
3. **数据分析**
|
||||
- 查看流量来源(搜索/推荐/付费/其他)
|
||||
- 分析转化率、客单价变化趋势
|
||||
- 输出《店铺周报》
|
||||
|
||||
### 三、每月运营任务(每月 1 日)
|
||||
|
||||
1. **月度复盘**
|
||||
- 统计月度 GMV、订单量、利润率
|
||||
- 对比上月数据,分析增长/下滑原因
|
||||
- 制定下月运营目标和策略
|
||||
|
||||
2. **竞品分析**
|
||||
- 监控 Top 3 竞品店铺动态
|
||||
- 分析竞品爆款商品和新品
|
||||
- 调整自身商品/价格策略
|
||||
|
||||
### 四、关键指标
|
||||
|
||||
| 指标 | 目标值 | 监控频率 |
|
||||
|------|--------|----------|
|
||||
| DSR 评分 | ≥ 4.8 | 每日 |
|
||||
| 48h 发货率 | ≥ 98% | 每日 |
|
||||
| 客服响应时长 | ≤ 3 分钟 | 每日 |
|
||||
| 转化率 | ≥ 行业均值 +10% | 每周 |
|
||||
| GMV 增长 | 月环比 ≥ 10% | 每月 |
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [抖店运营SOP.md](抖店运营SOP.md)
|
||||
- [数据分析方法.md](../运营/数据分析方法.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,21 +0,0 @@
|
||||
# 行政领域知识
|
||||
|
||||
**责任人**:刘诗妮(secretary)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖合同管理、报销流程、行政事务、供应商管理等行政支持知识。
|
||||
|
||||
## 条目清单
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [合同模板.md](合同模板.md) | 常用合同标准模板 | ✅ |
|
||||
| [报销流程.md](报销流程.md) | 费用报销申请与审批流程 | ✅ |
|
||||
|
||||
## 待建设
|
||||
|
||||
- 供应商管理指南
|
||||
- 会议纪要模板
|
||||
- 入职/离职流程
|
||||
@@ -0,0 +1,219 @@
|
||||
# 合同模板
|
||||
|
||||
> 标准合同模板,规范业务流程,降低法律风险
|
||||
|
||||
## 📌 目的
|
||||
|
||||
**为什么存在这个知识**:统一合同格式,保证关键条款完整,减少法务审核时间和法律风险
|
||||
|
||||
## 🎯 适用范围
|
||||
|
||||
**什么时候用**:客户合作、供应商合作、合作伙伴协议、劳务合同
|
||||
**谁在用**:刘诗妮(secretary)
|
||||
**前置条件**:合作意向已确认,商务条款已谈妥
|
||||
|
||||
## 📋 合同模板结构
|
||||
|
||||
### 合同编号:[年份]-[类型]-[序号]
|
||||
|
||||
# [合同类型] 合同
|
||||
|
||||
**甲方**(委托方):[公司全称]
|
||||
**统一社会信用代码**:[代码]
|
||||
**地址**:[注册地址]
|
||||
**法定代表人**:[姓名]
|
||||
**联系人**:[姓名]
|
||||
**联系电话**:[电话]
|
||||
|
||||
**乙方**(服务方/供货方):[公司全称/个人姓名]
|
||||
**统一社会信用代码/身份证号**:[代码/号码]
|
||||
**地址**:[地址]
|
||||
**法定代表人/联系人**:[姓名]
|
||||
**联系电话**:[电话]
|
||||
|
||||
---
|
||||
|
||||
## 第一条 合作内容
|
||||
|
||||
1.1 乙方向甲方提供以下服务/产品:
|
||||
- [详细描述服务/产品内容]
|
||||
- [规格/型号/数量]
|
||||
- [技术标准/质量要求]
|
||||
|
||||
1.2 服务/产品交付标准:
|
||||
- [具体验收标准]
|
||||
- [交付物清单]
|
||||
|
||||
## 第二条 合同期限
|
||||
|
||||
2.1 本合同有效期自 **____年__月__日** 至 **____年__月__日** 止。
|
||||
|
||||
2.2 合同到期前 [30] 日,双方可协商续签事宜。
|
||||
|
||||
## 第三条 合同金额及支付方式
|
||||
|
||||
3.1 合同总金额为人民币(大写):**____________元整** (¥________元)
|
||||
|
||||
3.2 支付方式:
|
||||
|
||||
| 期数 | 支付比例 | 金额 | 支付条件 |
|
||||
|------|----------|------|----------|
|
||||
| 第一期 | __% | ¥____元 | 合同签订后__个工作日内 |
|
||||
| 第二期 | __% | ¥____元 | [里程碑/验收] 后__个工作日内 |
|
||||
| 第三期 | __% | ¥____元 | [最终验收] 后__个工作日内 |
|
||||
|
||||
3.3 乙方应在甲方付款前提供等额增值税专用发票。
|
||||
|
||||
3.4 甲方收款账户信息:
|
||||
- 户名:[公司全称]
|
||||
- 开户行:[银行名称]
|
||||
- 账号:[银行账号]
|
||||
|
||||
## 第四条 双方权利和义务
|
||||
|
||||
**4.1 甲方权利和义务**
|
||||
- 按合同约定支付款项
|
||||
- 提供必要的工作配合
|
||||
- 按约定验收交付物
|
||||
- [其他]
|
||||
|
||||
**4.2 乙方权利和义务**
|
||||
- 按合同约定提供产品/服务
|
||||
- 保证产品/服务质量
|
||||
- 按期交付
|
||||
- 提供售后服务
|
||||
- [其他]
|
||||
|
||||
## 第五条 知识产权
|
||||
|
||||
5.1 本合同履行过程中产生的知识产权归属:
|
||||
- [ ] 归甲方所有
|
||||
- [ ] 归乙方所有
|
||||
- [ ] 双方共有
|
||||
- [ ] 其他:[具体约定]
|
||||
|
||||
5.2 双方保证不侵犯第三方知识产权。
|
||||
|
||||
## 第六条 保密条款
|
||||
|
||||
6.1 双方对在合作过程中知悉的对方商业秘密、技术秘密承担保密义务。
|
||||
|
||||
6.2 保密期限:合同有效期内及合同终止后 [3] 年。
|
||||
|
||||
6.3 未经对方书面同意,任何一方不得向第三方披露保密信息。
|
||||
|
||||
## 第七条 违约责任
|
||||
|
||||
7.1 任何一方违反本合同约定,应承担违约责任,赔偿对方因此遭受的损失。
|
||||
|
||||
7.2 乙方逾期交付的,每逾期一日,按合同总金额的 [0.5]% 支付违约金。
|
||||
|
||||
7.3 甲方逾期付款的,每逾期一日,按应付未付款的 [0.5]% 支付违约金。
|
||||
|
||||
7.4 违约金不足以弥补损失的,违约方还应赔偿差额部分。
|
||||
|
||||
## 第八条 合同解除
|
||||
|
||||
8.1 经双方协商一致,可以解除本合同。
|
||||
|
||||
8.2 有下列情形之一的,守约方有权解除合同:
|
||||
- 一方严重违约,致使合同目的无法实现
|
||||
- 一方破产、解散或被吊销营业执照
|
||||
- 不可抗力持续 [30] 日以上
|
||||
|
||||
8.3 合同解除后,双方应结清已履行部分的费用。
|
||||
|
||||
## 第九条 不可抗力
|
||||
|
||||
9.1 因不可抗力(包括但不限于自然灾害、战争、政府行为、疫情等)导致合同无法履行的,受影响方应及时通知对方,并提供相关证明。
|
||||
|
||||
9.2 受不可抗力影响的部分可免除责任,但应尽力减少损失。
|
||||
|
||||
## 第十条 争议解决
|
||||
|
||||
10.1 本合同履行过程中发生的争议,由双方协商解决。
|
||||
|
||||
10.2 协商不成的,任何一方均可向 **甲方所在地人民法院** 提起诉讼。
|
||||
|
||||
## 第十一条 其他
|
||||
|
||||
11.1 本合同未尽事宜,由双方另行签订补充协议,补充协议与本合同具有同等法律效力。
|
||||
|
||||
11.2 本合同一式 [贰] 份,甲乙双方各执 [壹] 份,具有同等法律效力。
|
||||
|
||||
11.3 本合同自双方签字盖章之日起生效。
|
||||
|
||||
11.4 通知送达地址:
|
||||
- 甲方送达地址:[地址],联系人:[姓名],电话:[电话]
|
||||
- 乙方送达地址:[地址],联系人:[姓名],电话:[电话]
|
||||
|
||||
---
|
||||
|
||||
**甲方**(盖章): **乙方**(盖章):
|
||||
|
||||
**授权代表**(签字):授权代表(签字):
|
||||
|
||||
**日期**:____年__月__日 **日期**:____年__月 __日
|
||||
|
||||
---
|
||||
|
||||
## 附件
|
||||
|
||||
- 附件一:服务/产品清单
|
||||
- 附件二:技术规格书
|
||||
- 附件三:报价单
|
||||
- [其他附件]
|
||||
|
||||
## ✅ 成功标准
|
||||
|
||||
- [ ] 合同条款完整,无遗漏
|
||||
- [ ] 商务条款清晰,无歧义
|
||||
- [ ] 法务审核通过
|
||||
- [ ] 双方签字盖章
|
||||
- [ ] 合同归档保存
|
||||
|
||||
## ⚠️ 常见问题
|
||||
|
||||
### Q1: 对方要求修改标准模板怎么办?
|
||||
|
||||
**原因**:对方有自己的法务要求、商务条款特殊
|
||||
**解决办法**:
|
||||
1. 评估修改内容是否触及核心利益
|
||||
2. 小修改可接受,大修改需法务审核
|
||||
3. 重大修改需领导审批
|
||||
**预防方法**:标准模板尽量完善,减少修改空间
|
||||
|
||||
### Q2: 合同执行过程中有变更怎么办?
|
||||
|
||||
**原因**:需求变化、情况变化
|
||||
**解决办法**:
|
||||
1. 签订补充协议
|
||||
2. 补充协议与原合同具有同等效力
|
||||
3. 明确变更内容和生效时间
|
||||
**预防方法**:合同预留变更机制
|
||||
|
||||
### Q3: 对方违约怎么办?
|
||||
|
||||
**原因**:对方不履约、逾期、质量不合格
|
||||
**解决办法**:
|
||||
1. 发函催告,保留证据
|
||||
2. 按合同追究违约责任
|
||||
3. 协商不成,走法律途径
|
||||
**预防方法**:合同明确违约责任,履约过程保留证据
|
||||
|
||||
## 🔗 相关资源
|
||||
|
||||
- 法务支持:[法务联系人]
|
||||
- 合同管理系统:[系统链接]
|
||||
- 工商查询:国家企业信用信息公示系统
|
||||
|
||||
## 📊 版本记录
|
||||
|
||||
| 版本 | 日期 | 更新内容 | 更新人 |
|
||||
|------|------|----------|--------|
|
||||
| v1.0 | 2026-06-22 | 初始创建 | 陆怀瑾 |
|
||||
|
||||
---
|
||||
|
||||
**责任人**:刘诗妮
|
||||
**最后更新**:2026-06-22
|
||||
+212
-63
@@ -1,83 +1,232 @@
|
||||
# 报销流程
|
||||
|
||||
## 元数据
|
||||
> 标准化费用报销流程,提高报销效率,规范财务管理
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 行政 |
|
||||
| **责任人** | 刘诗妮 (secretary) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | 行政, 报销, 财务, 流程 |
|
||||
## 📌 目的
|
||||
|
||||
## 概述
|
||||
**为什么存在这个知识**:统一报销流程,减少沟通成本,保证报销合规、及时到账
|
||||
|
||||
定义公司费用报销的标准流程,涵盖申请、审批、核销三大阶段,确保财务合规性和报销效率。
|
||||
## 🎯 适用范围
|
||||
|
||||
## 正文
|
||||
**什么时候用**:员工因公消费后申请报销
|
||||
**谁在用**:全体员工
|
||||
**前置条件**:消费已发生,取得合规发票
|
||||
|
||||
### 一、报销范围
|
||||
## 📋 报销流程
|
||||
|
||||
| 类别 | 说明 | 限额 |
|
||||
|------|------|------|
|
||||
| 差旅费 | 交通、住宿、餐饮 | 按出差地标准 |
|
||||
| 办公用品 | 设备、耗材、文具 | 单次 ≤ ¥2000 |
|
||||
| 招待费 | 客户/合作伙伴接待 | 需提前申请 |
|
||||
| 培训费 | 课程、考试、认证 | 需审批 |
|
||||
| 软件服务 | SaaS 订阅、API 费用 | 按需审批 |
|
||||
### 第一步:取得发票(消费时)
|
||||
|
||||
### 二、报销流程
|
||||
**发票要求**
|
||||
- 发票抬头:**[公司全称]**
|
||||
- 统一社会信用代码:[公司税号]
|
||||
- 发票内容与实际消费一致
|
||||
- 发票章清晰
|
||||
|
||||
**可报销票据类型**
|
||||
- [ ] 增值税专用发票
|
||||
- [ ] 增值税普通发票
|
||||
- [ ] 电子发票(需打印)
|
||||
- [ ] 行程单(机票)
|
||||
- [ ] 车票(火车、汽车)
|
||||
- [ ] 出租车票(需注明起止地点和事由)
|
||||
- [ ] 定额发票
|
||||
|
||||
**不可报销票据**
|
||||
- ❌ 个人消费发票
|
||||
- ❌ 发票抬头为个人
|
||||
- ❌ 发票内容模糊或不符
|
||||
- ❌ 收据/白条(特殊情况需审批)
|
||||
- ❌ 超过 [6 个月] 的发票
|
||||
|
||||
### 第二步:填写报销单(每周三前)
|
||||
|
||||
**报销渠道**
|
||||
- [方式 1] 飞书审批 - 费用报销
|
||||
- [方式 2] 钉钉审批 - 费用报销
|
||||
- [方式 3] 纸质报销单(特殊情况)
|
||||
|
||||
**报销单必填项**
|
||||
- 报销人姓名、部门
|
||||
- 报销事由(详细、具体)
|
||||
- 费用明细(分类填写)
|
||||
- 发票张数、总金额
|
||||
- 收款账户信息
|
||||
|
||||
**费用分类**
|
||||
- 差旅费(交通、住宿、餐饮)
|
||||
- 业务招待费
|
||||
- 办公用品
|
||||
- 推广费用
|
||||
- 培训费用
|
||||
- 其他(注明具体事项)
|
||||
|
||||
### 第三步:提交审批(每周三截止)
|
||||
|
||||
**审批流程**
|
||||
|
||||
```
|
||||
提交申请 → 直属审批 → COO 审批(> ¥5000)
|
||||
→ 刘总审批(> ¥20000) → 刘诗妮核销 → 归档
|
||||
报销人提交 → 直属上级审批 → 部门负责人审批 → 财务审核 → 总经理审批(>5000 元)→ 出纳付款
|
||||
```
|
||||
|
||||
**各环节时限**:
|
||||
- 员工提交:消费后 7 个工作日内
|
||||
- 直属审批:2 个工作日内
|
||||
- 核销:审批通过后 5 个工作日内
|
||||
**审批时效**
|
||||
- 直属上级:1 个工作日内
|
||||
- 部门负责人:1 个工作日内
|
||||
- 财务审核:2 个工作日内
|
||||
- 总经理审批:2 个工作日内(如需)
|
||||
- 出纳付款:3 个工作日内
|
||||
|
||||
### 三、报销材料
|
||||
|
||||
1. **发票**
|
||||
- 必须增值税普通/专用发票
|
||||
- 发票抬头:公司全称 + 税号
|
||||
- 电子发票可,纸质发票需原件
|
||||
|
||||
2. **报销单**
|
||||
- 事由:清晰说明消费目的
|
||||
- 明细:逐项列出费用+金额
|
||||
- 附件上传:发票图片/电子凭证
|
||||
|
||||
3. **特殊说明**
|
||||
- 差旅:附行程单
|
||||
- 招待:附参与人员名单
|
||||
- 大额采购:附比价记录
|
||||
|
||||
### 四、常见退回原因
|
||||
|
||||
| 原因 | 处理 |
|
||||
|------|------|
|
||||
| 发票信息错误(抬头/税号) | 退回重新开票 |
|
||||
| 超额未提前审批 | 补充说明或自付超额部分 |
|
||||
| 缺少明细说明 | 补充报销单信息 |
|
||||
| 超过报销时效 | 特殊说明后处理 |
|
||||
|
||||
### 五、审批人
|
||||
|
||||
| 金额区间 | 审批人 |
|
||||
**审批金额权限**
|
||||
| 金额范围 | 审批人 |
|
||||
|----------|--------|
|
||||
| ≤ ¥5000 | 直属负责人 |
|
||||
| ¥5001 ~ ¥20000 | + COO(陆怀瑾) |
|
||||
| > ¥20000 | + 刘总(Vincent) |
|
||||
| ≤1000 元 | 直属上级 |
|
||||
| 1000-5000 元 | 部门负责人 |
|
||||
| 5000-20000 元 | 总经理 |
|
||||
| >20000 元 | 总经理 + 财务负责人 |
|
||||
|
||||
## 相关条目
|
||||
### 第四步:财务审核
|
||||
|
||||
- [合同模板.md](合同模板.md)
|
||||
**审核要点**
|
||||
- 发票合规性(抬头、税号、印章)
|
||||
- 报销事由合理性
|
||||
- 费用标准符合公司制度
|
||||
- 单据完整性
|
||||
- 预算内支出
|
||||
|
||||
## 变更记录
|
||||
**常见问题处理**
|
||||
- 发票不合规 → 退回重开
|
||||
- 单据不全 → 补充材料
|
||||
- 超标费用 → 特殊审批或自理
|
||||
- 预算外 → 追加预算审批
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
### 第五步:打款(审核通过后 3 个工作日内)
|
||||
|
||||
**打款方式**
|
||||
- 银行转账(推荐)
|
||||
- 支付宝/微信(小额)
|
||||
|
||||
**打款时间**
|
||||
- 每周二、周五统一打款
|
||||
- 节假日顺延
|
||||
|
||||
## 📋 费用标准
|
||||
|
||||
### 差旅费标准
|
||||
|
||||
| 项目 | 员工 | 经理 | 总监及以上 |
|
||||
|------|------|------|------------|
|
||||
| 飞机 | 经济舱 | 经济舱 | 公务舱 |
|
||||
| 火车 | 二等座 | 一等座 | 商务座 |
|
||||
| 住宿(元/晚) | ≤400 | ≤600 | ≤1000 |
|
||||
| 餐饮补贴(元/天) | 100 | 150 | 200 |
|
||||
| 市内交通 | 实报实销 | 实报实销 | 实报实销 |
|
||||
|
||||
**差旅住宿说明**
|
||||
- 一线城市(北上广深):标准上浮 20%
|
||||
- 两人同行可同住一间,按较高标准执行
|
||||
|
||||
### 业务招待费标准
|
||||
|
||||
| 招待对象 | 标准(元/人) | 审批要求 |
|
||||
|----------|---------------|----------|
|
||||
| 普通客户 | ≤200 | 部门负责人 |
|
||||
| 重要客户 | ≤500 | 总经理 |
|
||||
| 战略伙伴 | ≤1000 | 总经理 + 财务 |
|
||||
|
||||
**招待费说明**
|
||||
- 需提前申请,注明招待对象、人数、事由
|
||||
- 报销时需提供消费清单
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
### 发票管理
|
||||
|
||||
- 电子发票需打印并承诺「未重复报销」
|
||||
- 发票丢失:需取得发票复印件 + 税务局证明
|
||||
- 发票抬头错误:需重开,不接受说明
|
||||
|
||||
### 报销时效
|
||||
|
||||
- 发票自开具之日起 [6 个月] 内报销
|
||||
- 超过期限需特殊审批,且不超当年
|
||||
|
||||
### 差旅报销
|
||||
|
||||
- 差旅前需填写《出差申请单》
|
||||
- 机票/酒店优先公司协议价
|
||||
- 自驾出差按 [1 元/公里] 补贴,过路费实报
|
||||
|
||||
### 禁止行为
|
||||
|
||||
- ❌ 虚报、多报
|
||||
- ❌ 替他人报销
|
||||
- ❌ 拆分发票规避审批
|
||||
- ❌ 使用假发票
|
||||
|
||||
**违规处理**
|
||||
- 首次:警告 + 追回款项
|
||||
- 二次:通报批评 + 罚款
|
||||
- 三次:辞退 + 法律追责
|
||||
|
||||
## ✅ 成功标准
|
||||
|
||||
- [ ] 报销单填写完整、准确
|
||||
- [ ] 发票合规、清晰
|
||||
- [ ] 审批流程顺利
|
||||
- [ ] 报销款及时到账
|
||||
- [ ] 无退单、无差错
|
||||
|
||||
## 📊 报销流程时效
|
||||
|
||||
| 环节 | 时效 | 责任方 |
|
||||
|------|------|--------|
|
||||
| 提交报销单 | 每周三前 | 报销人 |
|
||||
| 审批完成 | 3-5 个工作日 | 审批人 |
|
||||
| 财务审核 | 2 个工作日 | 财务 |
|
||||
| 打款 | 3 个工作日 | 出纳 |
|
||||
| **合计** | **约 7-10 个工作日** | |
|
||||
|
||||
## ⚠️ 常见问题
|
||||
|
||||
### Q1: 发票丢了怎么办?
|
||||
|
||||
**解决办法**:
|
||||
1. 联系开票方取得发票复印件
|
||||
2. 开票方主管税务机关出具《丢失增值税专用发票已报税证明单》
|
||||
3. 复印件 + 证明单可报销
|
||||
|
||||
### Q2: 紧急支出来不及走流程怎么办?
|
||||
|
||||
**解决办法**:
|
||||
1. 先微信/电话请示上级
|
||||
2. 事后 [3 个工作日] 内补流程
|
||||
3. 特殊情况可先借款,后冲销
|
||||
|
||||
### Q3: 报销被退单了怎么办?
|
||||
|
||||
**常见原因**:
|
||||
- 发票不合规 → 重开发票
|
||||
- 单据不全 → 补充材料
|
||||
- 超标 → 特殊审批或自理部分
|
||||
- 事由不清 → 补充说明
|
||||
|
||||
**处理流程**:
|
||||
1. 查看退单原因
|
||||
2. 补充/修改后重新提交
|
||||
3. 审批流程重新计算时效
|
||||
|
||||
## 🔗 相关资源
|
||||
|
||||
- 飞书审批入口:[链接]
|
||||
- 财务联系人:[姓名/电话]
|
||||
- 发票查验:[国家税务总局全国增值税发票查验平台](https://inv-veri.chinatax.gov.cn/)
|
||||
|
||||
## 📊 版本记录
|
||||
|
||||
| 版本 | 日期 | 更新内容 | 更新人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
| v1.0 | 2026-06-22 | 初始创建 | 陆怀瑾 |
|
||||
|
||||
---
|
||||
|
||||
**责任人**:刘诗妮
|
||||
**最后更新**:2026-06-22
|
||||
@@ -1,21 +0,0 @@
|
||||
# 设计领域知识
|
||||
|
||||
**责任人**:苏绘锦(designer)
|
||||
**审核人**:陆怀瑾(coo)
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖 UI/UX 设计规范、品牌元素、商详页设计、首图制作等设计知识。
|
||||
|
||||
## 条目清单
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [UI设计规范.md](UI设计规范.md) | 界面设计标准与组件规范 | ✅ |
|
||||
| [品牌元素指南.md](品牌元素指南.md) | 品牌色/字体/Logo 使用规范 | ✅ |
|
||||
|
||||
## 待建设
|
||||
|
||||
- 商详页设计模板
|
||||
- 首图设计规范
|
||||
- 移动端适配指南
|
||||
@@ -1,87 +0,0 @@
|
||||
# UI 设计规范
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 设计 |
|
||||
| **责任人** | 苏绘锦 (designer) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | UI, 设计规范, 组件, 视觉 |
|
||||
|
||||
## 概述
|
||||
|
||||
定义统一的 UI 设计标准,涵盖色彩、字体、间距、组件等基础规范,确保产品视觉一致性,降低设计-开发沟通成本。
|
||||
|
||||
## 正文
|
||||
|
||||
### 一、色彩系统
|
||||
|
||||
| 用途 | 色值 | 说明 |
|
||||
|------|------|------|
|
||||
| 主色 Primary | `#1677FF` | 按钮、链接、选中态 |
|
||||
| 成功 Success | `#52C41A` | 成功提示、通过状态 |
|
||||
| 警告 Warning | `#FAAD14` | 警告提示 |
|
||||
| 错误 Error | `#FF4D4F` | 错误提示、删除操作 |
|
||||
| 文字主色 | `#1F1F1F` | 标题、正文 |
|
||||
| 文字次色 | `#666666` | 辅助说明 |
|
||||
| 文字禁用 | `#BFBFBF` | 禁用/占位符 |
|
||||
| 边框 | `#D9D9D9` | 分割线、输入框边框 |
|
||||
| 背景 | `#F5F5F5` | 页面底色 |
|
||||
|
||||
### 二、字体规范
|
||||
|
||||
| 层级 | 字号 | 行高 | 字重 | 用途 |
|
||||
|------|------|------|------|------|
|
||||
| H1 | 24px | 32px | 600 | 页面主标题 |
|
||||
| H2 | 20px | 28px | 600 | 区块标题 |
|
||||
| H3 | 16px | 24px | 500 | 小标题 |
|
||||
| Body | 14px | 22px | 400 | 正文 |
|
||||
| Caption | 12px | 18px | 400 | 辅助/说明文字 |
|
||||
|
||||
默认字体:`-apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif`
|
||||
|
||||
### 三、间距体系
|
||||
|
||||
采用 4px 为基础单位的 8 点栅格:
|
||||
|
||||
| Token | 值 | 用途 |
|
||||
|-------|-----|------|
|
||||
| xs | 4px | 紧凑间距 |
|
||||
| sm | 8px | 元素内间距 |
|
||||
| md | 16px | 组件间距 |
|
||||
| lg | 24px | 区块间距 |
|
||||
| xl | 32px | 大区块分隔 |
|
||||
| xxl | 48px | 页面级分隔 |
|
||||
|
||||
### 四、圆角与阴影
|
||||
|
||||
| 组件 | 圆角 | 阴影 |
|
||||
|------|------|------|
|
||||
| 卡片 | 8px | `0 2px 8px rgba(0,0,0,0.08)` |
|
||||
| 弹窗 | 12px | `0 6px 16px rgba(0,0,0,0.12)` |
|
||||
| 按钮 | 6px | 无(默认)/ hover 时微阴影 |
|
||||
| 输入框 | 6px | 无(默认)/ focus 时外发光 |
|
||||
|
||||
### 五、响应式断点
|
||||
|
||||
| 断点 | 最小宽度 | 适用设备 |
|
||||
|------|----------|----------|
|
||||
| xs | < 576px | 手机竖屏 |
|
||||
| sm | ≥ 576px | 手机横屏 |
|
||||
| md | ≥ 768px | 平板 |
|
||||
| lg | ≥ 992px | 小桌面 |
|
||||
| xl | ≥ 1200px | 大桌面 |
|
||||
| xxl | ≥ 1600px | 超大屏 |
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [品牌元素指南.md](品牌元素指南.md)
|
||||
- [PRD模板.md](../产品/PRD模板.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,21 +0,0 @@
|
||||
# 运营领域知识
|
||||
|
||||
**责任人**:陆怀瑾(coo)
|
||||
**审核人**:刘炜承(Vincent)
|
||||
|
||||
## 知识范围
|
||||
|
||||
涵盖活动策划、数据分析、SOP 管理、流程优化、团队协作等运营管理知识。
|
||||
|
||||
## 条目清单
|
||||
|
||||
| 文件名 | 说明 | 状态 |
|
||||
|--------|------|------|
|
||||
| [活动策划模板.md](活动策划模板.md) | 营销活动策划标准模板 | ✅ |
|
||||
| [数据分析方法.md](数据分析方法.md) | 运营数据分析框架与方法 | ✅ |
|
||||
|
||||
## 待建设
|
||||
|
||||
- 周报模板
|
||||
- KPI 管理框架
|
||||
- 风险评估矩阵
|
||||
@@ -1,92 +0,0 @@
|
||||
# 数据分析方法
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 运营 |
|
||||
| **责任人** | 陆怀瑾 (coo) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | 数据分析, 运营, KPI, 看板 |
|
||||
|
||||
## 概述
|
||||
|
||||
建立全业务流程的数据分析框架,确保各业务线有统一的指标定义和分析方法,支撑数据驱动决策。
|
||||
|
||||
## 正文
|
||||
|
||||
### 一、核心指标体系
|
||||
|
||||
#### 1. 电商业务
|
||||
|
||||
| 层级 | 指标 | 定义 | 频率 |
|
||||
|------|------|------|------|
|
||||
| 北极星 | GMV | 总成交额 | 日/周/月 |
|
||||
| 过程 | 转化率 | 下单数/访客数 | 日 |
|
||||
| 过程 | 客单价 | GMV/订单数 | 周 |
|
||||
| 过程 | 退货率 | 退货数/订单数 | 周 |
|
||||
| 健康 | DSR | 描述/服务/物流评分 | 日 |
|
||||
| 健康 | 获客成本 CAC | 营销花费/新客数 | 月 |
|
||||
|
||||
#### 2. 内容业务
|
||||
|
||||
| 层级 | 指标 | 定义 | 频率 |
|
||||
|------|------|------|------|
|
||||
| 北极星 | 粉丝增长 | 净增粉丝数 | 周/月 |
|
||||
| 过程 | 互动率 | (点赞+收藏+评论)/曝光 | 篇 |
|
||||
| 过程 | 发布频率 | 每周发布篇数 | 周 |
|
||||
|
||||
#### 3. 公司整体
|
||||
|
||||
| 层级 | 指标 | 定义 | 频率 |
|
||||
|------|------|------|------|
|
||||
| 北极星 | 月营收 | 各业务线收入合计 | 月 |
|
||||
| 效率 | 人效 | 营收/团队人数 | 季 |
|
||||
| 效率 | Agent 利用率 | Agent 任务完成数/总分配数 | 周 |
|
||||
|
||||
### 二、分析框架
|
||||
|
||||
**AARRR 海盗模型**:
|
||||
|
||||
```
|
||||
Acquisition(获取)→ Activation(激活)→ Retention(留存)
|
||||
→ Revenue(收入)→ Referral(推荐)
|
||||
```
|
||||
|
||||
**电商应用示例**:
|
||||
1. Acquisition:各渠道流量来源占比
|
||||
2. Activation:首次下单转化率
|
||||
3. Retention:30 天复购率
|
||||
4. Revenue:LTV(用户生命周期价值)
|
||||
5. Referral:分享率、裂变系数
|
||||
|
||||
### 三、数据看板要求
|
||||
|
||||
每个业务线需维护以下看板:
|
||||
|
||||
| 看板 | 内容 | 更新频率 |
|
||||
|------|------|----------|
|
||||
| 日报 | 昨日核心指标 + 异常波动标注 | 每日 10:00 |
|
||||
| 周报 | 趋势图 + 同比/环比 + 分析洞察 | 每周一 |
|
||||
| 月报 | 完整指标矩阵 + 目标达成率 + 下月预测 | 每月 3 日 |
|
||||
|
||||
### 四、异常预警规则
|
||||
|
||||
| 条件 | 级别 | 响应 |
|
||||
|------|------|------|
|
||||
| GMV 日环比下降 > 20% | 🔴 | COO 立即介入 |
|
||||
| 转化率连续 3 天下降 | 🟡 | 业务负责人分析 |
|
||||
| 退货率 > 10% | 🟡 | 商品/客服联合排查 |
|
||||
| DSR < 4.6 | 🔴 | 立即优化 |
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [淘宝运营SOP.md](../电商/淘宝运营SOP.md)
|
||||
- [活动策划模板.md](活动策划模板.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,80 +0,0 @@
|
||||
# 活动策划模板
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 运营 |
|
||||
| **责任人** | 陆怀瑾 (coo) |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | 2026-06-22 |
|
||||
| **标签** | 运营, 活动策划, 营销, 模板 |
|
||||
|
||||
## 概述
|
||||
|
||||
标准化营销活动策划流程。适用于电商大促(618/双11/年货节)、店铺周年庆、新品发布、会员日活动等。
|
||||
|
||||
## 正文
|
||||
|
||||
### 一、活动策划文档结构
|
||||
|
||||
```
|
||||
# [活动名称] 策划方案
|
||||
|
||||
## 1. 活动背景与目标
|
||||
- 背景:[为什么做这次活动]
|
||||
- 核心目标:[可量化,如 GMV X万 / 新增粉丝 Y人]
|
||||
- 次要目标:[如品牌曝光、老客复购]
|
||||
|
||||
## 2. 目标用户
|
||||
- 主要人群:[画像描述]
|
||||
- 需求动机:[为什么他们会参与]
|
||||
|
||||
## 3. 活动机制
|
||||
- 玩法规则:[满减/秒杀/抽奖/打卡]
|
||||
- 用户路径:[从看到到参与的完整链路]
|
||||
- 激励机制:[优惠力度、稀缺性、社交裂变]
|
||||
|
||||
## 4. 资源与预算
|
||||
| 项目 | 预算 | 负责人 |
|
||||
|------|------|--------|
|
||||
| 流量投放 | ¥XX | [姓名] |
|
||||
| 商品补贴 | ¥XX | [姓名] |
|
||||
| 内容物料 | ¥XX | [姓名] |
|
||||
|
||||
## 5. 时间线
|
||||
| 阶段 | 时间 | 关键事项 |
|
||||
|------|------|----------|
|
||||
| 预热期 | D-7 ~ D-1 | 预告内容、优惠券发放 |
|
||||
| 爆发期 | D-Day | 主活动上线 |
|
||||
| 返场期 | D+1 ~ D+3 | 余热运营 |
|
||||
|
||||
## 6. 风险预案
|
||||
| 风险 | 概率 | 影响 | 应对 |
|
||||
|------|------|------|------|
|
||||
| 服务器崩溃 | 中 | 高 | 提前压测 + 降级方案 |
|
||||
| 库存不足 | 低 | 中 | 预售 + 安全库存预警 |
|
||||
|
||||
## 7. 复盘框架
|
||||
- 活动数据回顾(GMV/ROI/客单价/转化率)
|
||||
- 亮点与不足
|
||||
- 优化建议
|
||||
```
|
||||
|
||||
### 二、关键审批节点
|
||||
|
||||
1. **策划方案评审** → COO + 业务负责人
|
||||
2. **预算审批** → Vincent
|
||||
3. **法务合规审查** → 苏慎(如涉及抽奖/满赠)
|
||||
4. **上线前 Checklist** → 所有执行人确认
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [数据分析方法.md](数据分析方法.md)
|
||||
- [淘宝运营SOP.md](../电商/淘宝运营SOP.md)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| 2026-06-22 | v1.0 | 初始创建 | 陆怀瑾 |
|
||||
@@ -1,586 +0,0 @@
|
||||
# BIZ-24 HEARTBEAT.md 增强模板方案
|
||||
|
||||
> Phase 1 of BIZ-13 运行稳定性保障方案
|
||||
> 版本:v1.0
|
||||
> 编制:陆怀瑾(COO)
|
||||
> 日期:2026-06-22
|
||||
> 状态:待审阅
|
||||
> 关联:[BIZ-13 运行稳定性保障方案](BIZ-13_运行稳定性保障方案.md)
|
||||
|
||||
---
|
||||
|
||||
## 一、目标
|
||||
|
||||
为所有 Agent 的 HEARTBEAT.md 文件统一增强以下 5 项机制,解决任务停滞与运行异常问题:
|
||||
|
||||
1. **禁止请示规则** — 消除"等待用户确认"导致的任务卡死
|
||||
2. **超时检测规则** — 按 Agent 类型差异化配置心跳频率
|
||||
3. **自动恢复规则** — 检测无进展时自动重新调度
|
||||
4. **依赖检查前置** — 任务启动前强制检查所有依赖
|
||||
5. **最大轮次限制** — 防止无限循环或资源耗尽
|
||||
|
||||
---
|
||||
|
||||
## 二、Agent 分类与参数配置
|
||||
|
||||
### 2.1 分类标准
|
||||
|
||||
| 分类 | 特征 | Agent |
|
||||
|------|------|-------|
|
||||
| 高频 Agent | 需频繁检查任务状态、全局监控 | secretary, coo |
|
||||
| 开发 Agent | 执行开发/设计/部署等长周期任务 | projectmanager, productmanager, architect, costcodev, designer, opengineer |
|
||||
| 业务 Agent | 执行专项业务任务 | taobaospecialist, contentspecialist, mediaspecialist, cvexpert, marketanalysis, lawyer |
|
||||
|
||||
### 2.2 参数配置矩阵
|
||||
|
||||
| 参数 | 高频 Agent | 开发 Agent | 业务 Agent |
|
||||
|------|-----------|-----------|-----------|
|
||||
| 心跳频率 | 10 分钟 | 15 分钟 | 15 分钟 |
|
||||
| 最大轮次 | 50 轮 | 100 轮 | 30 轮 |
|
||||
| 超时告警阈值 | 20 分钟无进展 | 30 分钟无进展 | 30 分钟无进展 |
|
||||
| 自动恢复等待 | 30 分钟后重新调度 | 45 分钟后重新调度 | 45 分钟后重新调度 |
|
||||
| 告警通知对象 | COO | COO + 创建者 | 创建者 |
|
||||
|
||||
---
|
||||
|
||||
## 三、五项增强规则详解
|
||||
|
||||
### 规则 1:禁止请示规则
|
||||
|
||||
**问题**:Agent 发现任务后向用户请示"要不要做",用户不在线时任务卡死数小时。
|
||||
|
||||
**规则文本**:
|
||||
```markdown
|
||||
## ⚠️ 禁止请示规则(最高优先级)
|
||||
|
||||
你在心跳中发现 WorkBoard 任务后,必须立即执行,绝对禁止向用户请示!
|
||||
|
||||
原因:
|
||||
- 用户在大多数时候并不在线,请示会导致任务卡死数小时
|
||||
- 心跳是后台自动行为,用户没有义务实时响应你的请示
|
||||
- 你的职责是"主动完成交付",而不是"等待指令"
|
||||
|
||||
正确做法:
|
||||
1. 发现 status=todo 且 agentId=你的卡片
|
||||
2. 立即认领并执行
|
||||
3. 如遇信息不足,先按自己的最佳理解执行,执行中再调整
|
||||
4. 任务完成后,通知任务创建者
|
||||
|
||||
错误做法(绝对禁止):
|
||||
- ❌ "我发现了一个任务,要不要做?"
|
||||
- ❌ "这个任务需要更多信息,请告诉我..."
|
||||
- ❌ "任务已完成,请确认是否符合要求"
|
||||
```
|
||||
|
||||
### 规则 2:超时检测规则
|
||||
|
||||
**问题**:Agent 执行到某一步后卡住,长时间无输出,无任何监告。
|
||||
|
||||
**规则文本**:
|
||||
|
||||
高频 Agent 版:
|
||||
```markdown
|
||||
## ⏱️ 超时检测规则
|
||||
|
||||
### 心跳频率:10 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查所有进行中任务的最新更新时间
|
||||
2. 如超过 20 分钟无进展 → 标记为"疑似超时"
|
||||
3. 疑似超时 → 立即追加一次完整心跳,尝试推进
|
||||
4. 如确认超时 → 进入自动恢复流程
|
||||
|
||||
### 检测脚本
|
||||
\```bash
|
||||
# 检查进行中任务是否超时
|
||||
openclaw workboard list --json 2>/dev/null | python3 -c "
|
||||
import sys, json, time
|
||||
data = json.load(sys.stdin)
|
||||
inprogress = [c for c in data.get('cards', []) if c.get('status') == 'in_progress']
|
||||
now = time.time()
|
||||
for c in inprogress:
|
||||
updated = c.get('updated_at', '')
|
||||
if updated:
|
||||
age = now - time.mktime(time.strptime(updated[:19], '%Y-%m-%dT%H:%M:%S'))
|
||||
if age > 1200: # 20 分钟
|
||||
print(f'⏰ TIMEOUT: {c[\"id\"][:8]} [{c.get(\"agentId\",\"?\")}] {c[\"title\"]}')
|
||||
"
|
||||
\```
|
||||
```
|
||||
|
||||
开发 Agent 版(差异部分):
|
||||
```markdown
|
||||
### 心跳频率:15 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查所有进行中任务的最新更新时间
|
||||
2. 如超过 30 分钟无进展 → 标记为"疑似超时"
|
||||
```
|
||||
|
||||
业务 Agent 版(差异部分):
|
||||
```markdown
|
||||
### 心跳频率:15 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查所有进行中任务的最新更新时间
|
||||
2. 如超过 30 分钟无进展 → 标记为"疑似超时"
|
||||
```
|
||||
|
||||
### 规则 3:自动恢复规则
|
||||
|
||||
**问题**:检测到无进展后没有自动恢复手段,任务永久停滞。
|
||||
|
||||
**规则文本**:
|
||||
```markdown
|
||||
## 🔄 自动恢复规则
|
||||
|
||||
### 恢复流程
|
||||
```
|
||||
检测到超时(无进展超阈值)
|
||||
↓
|
||||
步骤 1:追加一次完整心跳,尝试推进任务
|
||||
↓
|
||||
步骤 2:检查任务状态
|
||||
↓
|
||||
┌─────────────┴─────────────┐
|
||||
│ │
|
||||
有进展 仍无进展
|
||||
│ │
|
||||
重置超时计数器 步骤 3:通知 COO/创建者
|
||||
│ │
|
||||
继续执行 步骤 4:标记为 blocked
|
||||
│
|
||||
步骤 5:重新调度(分配备用 Agent 或
|
||||
等待人工介入)
|
||||
```
|
||||
|
||||
### 自动恢复触发条件
|
||||
- 高频 Agent:超 30 分钟无进展 → 自动重新调度
|
||||
- 开发 Agent:超 45 分钟无进展 → 自动重新调度
|
||||
- 业务 Agent:超 45 分钟无进展 → 自动重新调度
|
||||
|
||||
### 恢复操作
|
||||
1. 停止当前任务执行
|
||||
2. 在任务中添加评论说明超时原因
|
||||
3. 释放 Agent 认领(release claim)
|
||||
4. 通知 COO 重新分配
|
||||
5. 如任务可重试 → 创建重新调度标记
|
||||
|
||||
### 恢复脚本示例
|
||||
\```bash
|
||||
# 自动恢复:重新调度超时任务
|
||||
openclaw workboard list --json 2>/dev/null | python3 -c "
|
||||
import sys, json, time
|
||||
data = json.load(sys.stdin)
|
||||
timed_out = [c for c in data.get('cards', [])
|
||||
if c.get('status') == 'in_progress'
|
||||
and c.get('agentId') in ['agent_id_list']]
|
||||
for c in timed_out:
|
||||
# 检查是否超过自动恢复阈值
|
||||
# 如超过 → 释放认领,通知 COO
|
||||
print(f'RECOVER: {c[\"id\"][:8]}')
|
||||
"
|
||||
\```
|
||||
```
|
||||
|
||||
### 规则 4:依赖检查前置
|
||||
|
||||
**问题**:任务开始后才发现依赖未满足,浪费 Agent 时间,且可能导致循环等待。
|
||||
|
||||
**规则文本**:
|
||||
```markdown
|
||||
## 🔗 依赖检查前置规则
|
||||
|
||||
### 任务启动前强制检查
|
||||
每次认领或启动任务前,必须执行依赖检查:
|
||||
|
||||
1. 读取任务的 depends_on 字段
|
||||
2. 逐一检查每个依赖任务的状态
|
||||
3. 所有依赖 ready → 可以启动
|
||||
4. 任一依赖未完成 → 禁止启动,标记为 blocked
|
||||
|
||||
### 检查脚本
|
||||
\```bash
|
||||
# 依赖检查
|
||||
openclaw workboard read <card-id> --json 2>/dev/null | python3 -c "
|
||||
import sys, json
|
||||
card = json.load(sys.stdin)
|
||||
deps = card.get('dependsOn', [])
|
||||
if deps:
|
||||
for dep in deps:
|
||||
print(f'依赖: {dep[\"id\"]} → 状态: {dep.get(\"status\", \"?\")}')
|
||||
if dep.get('status') != 'done':
|
||||
print(f'⛔ 依赖未满足,禁止启动任务 {card[\"id\"][:8]}')
|
||||
sys.exit(1)
|
||||
print('✅ 所有依赖已满足')
|
||||
else:
|
||||
print('✅ 无依赖,可以启动')
|
||||
"
|
||||
\```
|
||||
|
||||
### 依赖未满足时的处理
|
||||
1. 不认领任务(保持 todo 状态)
|
||||
2. 不在该任务上浪费心跳时间
|
||||
3. 如超过等待阈值(高频 1h / 开发/业务 2h),通知依赖任务的执行者
|
||||
```
|
||||
|
||||
### 规则 5:最大轮次限制
|
||||
|
||||
**问题**:Agent 陷入无限循环,反复执行相同逻辑无进展,持续消耗 API 配额。
|
||||
|
||||
**规则文本**:
|
||||
|
||||
高频 Agent 版:
|
||||
```markdown
|
||||
## 🛑 最大轮次限制
|
||||
|
||||
### 限制值:50 轮
|
||||
单次任务执行不得超过 50 个对话轮次。
|
||||
|
||||
### 检测机制
|
||||
- 每次心跳记录已消耗轮次
|
||||
- 接近上限(80%)时发出预警
|
||||
- 达到上限时自动暂停
|
||||
|
||||
### 超限处理
|
||||
```
|
||||
达到最大轮次
|
||||
↓
|
||||
1. 暂停任务执行
|
||||
2. 记录已完成的步骤和未完成的部分
|
||||
3. 通知 COO,附当前进度
|
||||
4. COO 决定:重新分配 / 拆分任务 / 人工介入
|
||||
```
|
||||
|
||||
### 计数器维护
|
||||
\```bash
|
||||
# 每次心跳更新轮次计数
|
||||
# 轮次数据存储在任务 metadata 或 comment 中
|
||||
\```
|
||||
```
|
||||
|
||||
开发 Agent 版(差异部分):
|
||||
```markdown
|
||||
### 限制值:100 轮
|
||||
单次任务执行不得超过 100 个对话轮次。
|
||||
```
|
||||
|
||||
业务 Agent 版(差异部分):
|
||||
```markdown
|
||||
### 限制值:30 轮
|
||||
单次任务执行不得超过 30 个对话轮次。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、HEARTBEAT.md 完整增强模板
|
||||
|
||||
### 4.1 高频 Agent 完整模板(secretary / coo)
|
||||
|
||||
```markdown
|
||||
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||
|
||||
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||
|
||||
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||
|
||||
### 执行流程(严格执行,无需确认)
|
||||
1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片
|
||||
2. **立即执行,不得请示** — 发现待办卡片后直接执行
|
||||
3. **检查进行中卡片** — 确认认领的任务状态
|
||||
4. **完成任务** — 完成后通知任务创建者
|
||||
|
||||
### ⚠️ 绝对禁止行为
|
||||
- ❌ 不得问"要不要做这个任务"
|
||||
- ❌ 不得等用户确认再执行
|
||||
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ 超时检测规则
|
||||
|
||||
### 心跳频率:10 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查进行中任务的最新更新时间
|
||||
2. 超过 20 分钟无进展 → 标记为"疑似超时"
|
||||
3. 疑似超时 → 追加一次完整心跳尝试推进
|
||||
4. 确认超时 → 进入自动恢复流程
|
||||
|
||||
---
|
||||
|
||||
## 🔄 自动恢复规则
|
||||
|
||||
### 触发条件
|
||||
- 超 30 分钟无进展 → 自动重新调度
|
||||
|
||||
### 恢复操作
|
||||
1. 停止当前任务执行
|
||||
2. 添加评论说明超时原因
|
||||
3. 释放 Agent 认领
|
||||
4. 通知 COO 重新分配
|
||||
5. 创建重新调度标记
|
||||
|
||||
---
|
||||
|
||||
## 🔗 依赖检查前置规则
|
||||
|
||||
### 强制检查流程
|
||||
1. 认领任务前,读取 depends_on 字段
|
||||
2. 逐一检查每个依赖任务的状态
|
||||
3. 依赖未满足 → 不认领(保持 todo)
|
||||
4. 超过等待阈值(1h)→ 通知依赖任务执行者
|
||||
|
||||
---
|
||||
|
||||
## 🛑 最大轮次限制
|
||||
|
||||
### 限制值:50 轮
|
||||
- 接近 80%(40 轮)→ 预警
|
||||
- 达到上限 → 暂停,通知 COO
|
||||
|
||||
---
|
||||
|
||||
## 🫀 心跳执行清单
|
||||
|
||||
1. ✅ WorkBoard 任务检查
|
||||
2. ✅ 进行中任务超时检测
|
||||
3. ✅ 依赖检查
|
||||
4. ✅ 轮次计数器更新
|
||||
5. ✅ [Agent 专属检查项]
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 全局关键规则
|
||||
|
||||
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||
3. **发现任务立即执行,不得请示**
|
||||
4. **超时任务按自动恢复流程处理**
|
||||
5. **依赖未满足不启动**
|
||||
6. **达到轮次上限自动暂停**
|
||||
```
|
||||
|
||||
### 4.2 开发 Agent 完整模板(projectmanager / productmanager / architect / costcodev / designer / opengineer)
|
||||
|
||||
```markdown
|
||||
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||
|
||||
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||
|
||||
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||
|
||||
### 执行流程(严格执行,无需确认)
|
||||
1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片
|
||||
2. **立即执行,不得请示** — 发现待办卡片后直接执行
|
||||
3. **检查进行中卡片** — 确认认领的任务状态
|
||||
4. **完成任务** — 完成后通知任务创建者
|
||||
|
||||
### ⚠️ 绝对禁止行为
|
||||
- ❌ 不得问"要不要做这个任务"
|
||||
- ❌ 不得等用户确认再执行
|
||||
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ 超时检测规则
|
||||
|
||||
### 心跳频率:15 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查进行中任务的最新更新时间
|
||||
2. 超过 30 分钟无进展 → 标记为"疑似超时"
|
||||
3. 疑似超时 → 追加一次完整心跳尝试推进
|
||||
4. 确认超时 → 进入自动恢复流程
|
||||
|
||||
---
|
||||
|
||||
## 🔄 自动恢复规则
|
||||
|
||||
### 触发条件
|
||||
- 超 45 分钟无进展 → 自动重新调度
|
||||
|
||||
### 恢复操作
|
||||
1. 停止当前任务执行
|
||||
2. 添加评论说明超时原因
|
||||
3. 释放 Agent 认领
|
||||
4. 通知 COO 和任务创建者
|
||||
5. 创建重新调度标记
|
||||
|
||||
---
|
||||
|
||||
## 🔗 依赖检查前置规则
|
||||
|
||||
### 强制检查流程
|
||||
1. 认领任务前,读取 depends_on 字段
|
||||
2. 逐一检查每个依赖任务的状态
|
||||
3. 依赖未满足 → 不认领(保持 todo)
|
||||
4. 超过等待阈值(2h)→ 通知依赖任务执行者
|
||||
|
||||
---
|
||||
|
||||
## 🛑 最大轮次限制
|
||||
|
||||
### 限制值:100 轮
|
||||
- 接近 80%(80 轮)→ 预警
|
||||
- 达到上限 → 暂停,记录日志
|
||||
|
||||
---
|
||||
|
||||
## 🫀 心跳执行清单
|
||||
|
||||
1. ✅ WorkBoard 任务检查
|
||||
2. ✅ 进行中任务超时检测
|
||||
3. ✅ 依赖检查
|
||||
4. ✅ 轮次计数器更新
|
||||
5. ✅ [Agent 专属检查项]
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 全局关键规则
|
||||
|
||||
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||
3. **发现任务立即执行,不得请示**
|
||||
4. **超时任务按自动恢复流程处理**
|
||||
5. **依赖未满足不启动**
|
||||
6. **达到轮次上限自动暂停**
|
||||
```
|
||||
|
||||
### 4.3 业务 Agent 完整模板(taobaospecialist / contentspecialist / mediaspecialist / cvexpert / marketanalysis / lawyer)
|
||||
|
||||
```markdown
|
||||
# HEARTBEAT.md - [Agent Name] 的心跳配置
|
||||
|
||||
## ⚠️ 禁止请示规则(最高优先级,自动执行)
|
||||
|
||||
> **核心规则:发现分配给自己的任务 → 立即执行,不得向用户请示!**
|
||||
> 心跳是后台自动行为,用户在大多数时候并不在线,请示会导致任务卡死。
|
||||
|
||||
### 执行流程(严格执行,无需确认)
|
||||
1. **检查待办卡片** — 查找 agent_id 为自己且 status=todo 的卡片
|
||||
2. **立即执行,不得请示** — 发现待办卡片后直接执行
|
||||
3. **检查进行中卡片** — 确认认领的任务状态
|
||||
4. **完成任务** — 完成后通知任务创建者
|
||||
|
||||
### ⚠️ 绝对禁止行为
|
||||
- ❌ 不得问"要不要做这个任务"
|
||||
- ❌ 不得等用户确认再执行
|
||||
- ❌ 不得以"需要更多信息"为由拒绝执行
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ 超时检测规则
|
||||
|
||||
### 心跳频率:15 分钟
|
||||
每次心跳执行以下检测:
|
||||
1. 检查进行中任务的最新更新时间
|
||||
2. 超过 30 分钟无进展 → 标记为"疑似超时"
|
||||
3. 疑似超时 → 追加一次完整心跳尝试推进
|
||||
4. 确认超时 → 进入自动恢复流程
|
||||
|
||||
---
|
||||
|
||||
## 🔄 自动恢复规则
|
||||
|
||||
### 触发条件
|
||||
- 超 45 分钟无进展 → 自动重新调度
|
||||
|
||||
### 恢复操作
|
||||
1. 停止当前任务执行
|
||||
2. 添加评论说明超时原因
|
||||
3. 释放 Agent 认领
|
||||
4. 通知任务创建者
|
||||
5. 创建重新调度标记
|
||||
|
||||
---
|
||||
|
||||
## 🔗 依赖检查前置规则
|
||||
|
||||
### 强制检查流程
|
||||
1. 认领任务前,读取 depends_on 字段
|
||||
2. 逐一检查每个依赖任务的状态
|
||||
3. 依赖未满足 → 不认领(保持 todo)
|
||||
4. 超过等待阈值(2h)→ 通知依赖任务执行者
|
||||
|
||||
---
|
||||
|
||||
## 🛑 最大轮次限制
|
||||
|
||||
### 限制值:30 轮
|
||||
- 接近 80%(24 轮)→ 预警
|
||||
- 达到上限 → 暂停,通知创建者
|
||||
|
||||
---
|
||||
|
||||
## 🫀 心跳执行清单
|
||||
|
||||
1. ✅ WorkBoard 任务检查
|
||||
2. ✅ 进行中任务超时检测
|
||||
3. ✅ 依赖检查
|
||||
4. ✅ 轮次计数器更新
|
||||
5. ✅ [Agent 专属检查项]
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 全局关键规则
|
||||
|
||||
1. **心跳不打断对话** — 用户正在对话时延后执行
|
||||
2. **非紧急事项延后汇报** — 等下一轮心跳或用户询问
|
||||
3. **发现任务立即执行,不得请示**
|
||||
4. **超时任务按自动恢复流程处理**
|
||||
5. **依赖未满足不启动**
|
||||
6. **达到轮次上限自动暂停**
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、部署清单
|
||||
|
||||
### 5.1 各 Agent HEARTBEAT.md 更新状态
|
||||
|
||||
| Agent | 分类 | 模板版本 | 部署状态 | 部署人 |
|
||||
|-------|------|---------|---------|--------|
|
||||
| secretary (刘诗妮) | 高频 | 高频 Agent 模板 | 待部署 | COO |
|
||||
| coo (陆怀瑾) | 高频 | 高频 Agent 模板 | 待部署 | COO |
|
||||
| projectmanager (胡蓉) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| productmanager (沈路明) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| architect (梁思筑) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| costcodev (徐聪) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| designer (苏绘锦) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| opengineer (严维序) | 开发 | 开发 Agent 模板 | 待部署 | COO |
|
||||
| taobaospecialist (陆云帆) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
| contentspecialist (文墨言) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
| mediaspecialist (钟帧韵) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
| cvexpert (程伯予) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
| marketanalysis (顾析策) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
| lawyer (苏慎) | 业务 | 业务 Agent 模板 | 待部署 | COO |
|
||||
|
||||
### 5.2 部署步骤
|
||||
|
||||
1. **Vincent 审阅本方案** — 确认参数配置
|
||||
2. **创建 HEARTBEAT.md 文件** — 按模板为每个 Agent 创建(以 [Agent Name] 替换占位符)
|
||||
3. **配置心跳 cron** — 按分类配置定时任务
|
||||
4. **部署到各 Agent workspace** — 将 HEARTBEAT.md 分发到对应 Agent 工作区
|
||||
5. **验证** — 等待一轮完整心跳,检查是否有任务停滞告警
|
||||
|
||||
---
|
||||
|
||||
## 六、交付物
|
||||
|
||||
- [x] HEARTBEAT.md 增强模板方案(本文档)
|
||||
- [ ] 14 个 Agent 的独立 HEARTBEAT.md 文件(待审阅后生成)
|
||||
- [ ] 心跳 cron 配置脚本
|
||||
- [ ] 部署验证报告
|
||||
|
||||
---
|
||||
|
||||
## 七、风险与注意事项
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|----------|
|
||||
| 心跳自身卡死 | 所有监控失效 | 独立的 watchdog 进程监控心跳 cron 执行 |
|
||||
| 自动恢复过于激进 | 正常长任务被中断 | 仅对超阈值且无进展的任务执行恢复 |
|
||||
| 禁止请示导致错误执行 | Agent 自行决定后出错 | 关键决策(涉及外部资源、金钱)仍需暂停并通知 |
|
||||
| 轮次限制过严 | 复杂任务被截断 | 接近上限时提前预警,COO 可手动扩展 |
|
||||
|
||||
---
|
||||
|
||||
> ⚠️ 本方案需 Vincent 审阅后方可部署到各 Agent workspace。当前为模板方案,存放于 EnterpriseArchitect/plans/ 目录。
|
||||
@@ -1,62 +0,0 @@
|
||||
#!/bin/bash
|
||||
# wiki-lint-check.sh — Wiki 知识库质量检查脚本
|
||||
#
|
||||
# 用途: 定期运行 wiki_lint 检查知识库质量,生成报告
|
||||
# 用法: ./scripts/wiki-lint-check.sh [--report-dir <dir>]
|
||||
#
|
||||
# 建议通过 cron 定期执行,例如每日凌晨:
|
||||
# 0 2 * * * cd /path/to/EnterpriseArchitect && ./scripts/wiki-lint-check.sh
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
REPORT_DIR="${REPORT_DIR:-/tmp/wiki-lint-reports}"
|
||||
TIMESTAMP=$(date '+%Y-%m-%d_%H%M%S')
|
||||
REPORT_FILE="${REPORT_DIR}/wiki-lint-${TIMESTAMP}.md"
|
||||
|
||||
mkdir -p "$REPORT_DIR"
|
||||
|
||||
echo "=== Wiki Lint Check ==="
|
||||
echo "时间: $(date '+%Y-%m-%d %H:%M:%S %Z')"
|
||||
echo "报告路径: $REPORT_FILE"
|
||||
echo ""
|
||||
|
||||
# 运行 wiki_lint(通过 OpenClaw CLI)
|
||||
# 注意: 此脚本需在 OpenClaw 环境中执行
|
||||
LINT_RESULT=$(openclaw skill wiki-lint 2>&1) || true
|
||||
|
||||
# 生成报告
|
||||
cat > "$REPORT_FILE" << EOF
|
||||
# Wiki Lint 检查报告
|
||||
|
||||
**检查时间**: $(date '+%Y-%m-%d %H:%M:%S %Z')
|
||||
**执行主机**: $(hostname)
|
||||
**执行用户**: $(whoami)
|
||||
|
||||
---
|
||||
|
||||
## 检查结果
|
||||
|
||||
\`\`\`
|
||||
${LINT_RESULT:-No output from wiki_lint}
|
||||
\`\`\`
|
||||
|
||||
---
|
||||
|
||||
## 状态
|
||||
|
||||
EOF
|
||||
|
||||
if echo "$LINT_RESULT" | grep -qi "error\|fail\|issue"; then
|
||||
echo "**状态**: ⚠️ 发现问题,需处理" >> "$REPORT_FILE"
|
||||
echo ""
|
||||
echo "⚠️ Wiki Lint 发现问题,请检查: $REPORT_FILE"
|
||||
else
|
||||
echo "**状态**: ✅ 无问题" >> "$REPORT_FILE"
|
||||
echo ""
|
||||
echo "✅ Wiki Lint 检查通过"
|
||||
fi
|
||||
|
||||
echo "报告已生成: $REPORT_FILE"
|
||||
|
||||
# 清理 30 天以前的旧报告
|
||||
find "$REPORT_DIR" -name "wiki-lint-*.md" -mtime +30 -delete 2>/dev/null || true
|
||||
@@ -1,279 +0,0 @@
|
||||
# 多智能体文档存储、命名与索引规范 v1.0
|
||||
|
||||
> 版本:v1.0(实施版)
|
||||
> 编制:陆怀瑾(COO)
|
||||
> 日期:2026-06-22
|
||||
> 状态:已批准,执行中
|
||||
> 适用范围:所有 Agent 的 workspace 目录
|
||||
|
||||
---
|
||||
|
||||
## 一、统一目录结构
|
||||
|
||||
每个 Agent 的 workspace 必须采用以下标准目录结构:
|
||||
|
||||
```
|
||||
workspace/
|
||||
├── AGENTS.md # Agent 协作协议
|
||||
├── MEMORY.md # 长期记忆 → 含文档索引表(核心)
|
||||
├── SOUL.md # 角色定义 → 引用外部内容,不填塞
|
||||
├── IDENTITY.md # 身份信息
|
||||
├── USER.md # 用户画像
|
||||
├── TOOLS.md # 工具清单 → 仅保留索引,详情外挂
|
||||
├── HEARTBEAT.md # 心跳配置
|
||||
│
|
||||
├── memory/ # 记忆归档目录(按日期)
|
||||
│ └── YYYY-MM-DD.md
|
||||
│
|
||||
├── docs/ # 项目文档目录(按项目分)
|
||||
│ └── {project}/
|
||||
│ ├── README.md
|
||||
│ └── ...
|
||||
│
|
||||
├── plans/ # 方案文档目录
|
||||
│ └── YYYY-MM-DD_{topic}.md
|
||||
│
|
||||
├── specs/ # 规范/标准文档目录
|
||||
│ └── BIZ-XX_{name}_v{M}.{N}.md
|
||||
│
|
||||
├── reports/ # 运营报告目录
|
||||
│ └── YYYY-Q{N}_{type}_v{M}.{N}.md
|
||||
│
|
||||
├── knowledge/ # 知识库目录(按领域分)
|
||||
│ └── {domain}/
|
||||
│ └── {topic}.md
|
||||
│
|
||||
├── tasks/ # 任务文件目录(可选)
|
||||
│ └── ...
|
||||
│
|
||||
└── assets/ # 资源文件目录
|
||||
├── images/
|
||||
├── files/
|
||||
└── templates/
|
||||
```
|
||||
|
||||
### 目录用途速查
|
||||
|
||||
| 目录 | 用途 | Token 影响 |
|
||||
|------|------|-----------|
|
||||
| 根目录 .md | Agent 核心配置 | **直接影响 Token**,必须精简 |
|
||||
| memory/ | 按日归档记忆 | 通过 memory_search 检索,不占用上下文 |
|
||||
| docs/ | 项目文档 | 按需加载 |
|
||||
| plans/ | 方案文档 | 仅 COO 维护 |
|
||||
| specs/ | 规范标准 | 按需加载 |
|
||||
| reports/ | 运营报告 | 仅 COO 维护 |
|
||||
| knowledge/ | 知识库 | 知识库检索,不占用上下文 |
|
||||
| assets/ | 二进制资源 | 不占用上下文 |
|
||||
|
||||
---
|
||||
|
||||
## 二、文件命名规则
|
||||
|
||||
### 2.1 强制命名格式
|
||||
|
||||
```
|
||||
{日期/编号}_{中文主题}_{版本}.md
|
||||
```
|
||||
|
||||
### 2.2 各目录命名约定
|
||||
|
||||
| 目录 | 命名模式 | 示例 |
|
||||
|------|----------|------|
|
||||
| memory/ | `YYYY-MM-DD.md` | `2026-06-22.md` |
|
||||
| plans/ | `YYYY-MM-DD_{主题}.md` | `2026-06-22_多智能体协作体系总体方案.md` |
|
||||
| specs/ | `BIZ-{编号}_{主题}_v{M}.{N}.md` | `BIZ-12_文档存储规范_v1.0.md` |
|
||||
| reports/ | `YYYY-Q{N}_{类型}_v{M}.{N}.md` | `2026-Q2_运营效率报告_v1.0.md` |
|
||||
| knowledge/ | `{主题}_v{M}.{N}.md` | `淘宝运营_SOP_v1.0.md` |
|
||||
| docs/{project}/ | `{功能}_{版本}.md` | `requirements_v1.0.md` |
|
||||
| memory/ day file | `YYYY-MM-DD.md` | `2026-06-22.md` |
|
||||
|
||||
### 2.3 禁止事项
|
||||
|
||||
- ❌ 使用特殊字符:`/ \ : * ? " < > |` 空格
|
||||
- ❌ 超过 80 字符的文件名
|
||||
- ❌ 不含日期/编号的裸文件名
|
||||
- ❌ 中文和英文混排无分隔符
|
||||
- ✅ 统一使用下划线 `_` 作为分隔符
|
||||
|
||||
---
|
||||
|
||||
## 三、索引机制(核心)
|
||||
|
||||
### 3.1 索引分离原则(刘总反馈已纳入)
|
||||
|
||||
> **配置文件只保留索引指针,详细内容外挂存储。**
|
||||
|
||||
此原则适用场景:
|
||||
- **TOOLS.md**:只列工具名称 + 引用路径,不列完整参数
|
||||
- **待办列表**:只记录 ID + 主题 + 状态,详情在独立文件中
|
||||
- **Agent 协作表**:只列 Agent 名 + 职能 + Session Key,详情在各自文件
|
||||
- **知识索引**:MEMORY.md 只保留索引表,知识条目在 knowledge/ 中
|
||||
|
||||
### 3.2 MEMORY.md 索引表模板
|
||||
|
||||
```markdown
|
||||
# MEMORY.md - {Agent Name} 长期记忆
|
||||
|
||||
## 📑 文档索引
|
||||
|
||||
### 方案文档
|
||||
| 日期 | 主题 | 路径 | 状态 |
|
||||
|------|------|------|------|
|
||||
| 2026-06-22 | 多智能体协作体系 | plans/2026-06-22_多智能体协作体系总体方案.md | 已批准 |
|
||||
|
||||
### 规范标准
|
||||
| 编号 | 主题 | 路径 | 版本 |
|
||||
|------|------|------|------|
|
||||
| BIZ-12 | 文档存储规范 | specs/BIZ-12_文档存储规范_v1.0.md | v1.0 |
|
||||
|
||||
### 项目文档
|
||||
| 项目 | 文档 | 路径 | 状态 |
|
||||
|------|------|------|------|
|
||||
|
||||
### 运营报告
|
||||
| 周期 | 类型 | 路径 | 状态 |
|
||||
|------|------|------|------|
|
||||
|
||||
### 知识库条目
|
||||
| 领域 | 主题 | 路径 | 更新时间 |
|
||||
|------|------|------|----------|
|
||||
|
||||
---
|
||||
(以下是实际记忆内容...)
|
||||
```
|
||||
|
||||
### 3.3 各目录 README.md 模板
|
||||
|
||||
每个目录应有一个 `README.md`:
|
||||
|
||||
```markdown
|
||||
# {目录名称}
|
||||
|
||||
> 最后更新:{YYYY-MM-DD}
|
||||
> 维护者:{Agent Name}
|
||||
|
||||
## 目录说明
|
||||
{简短描述本目录的用途和使用规范}
|
||||
|
||||
## 文件列表
|
||||
| 文件名 | 描述 | 最后更新 |
|
||||
|--------|------|----------|
|
||||
| ... | ... | ... |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、检索体系
|
||||
|
||||
### 4.1 分层检索路径
|
||||
|
||||
```
|
||||
第一层:memory_search(语义检索,跨 memory/*.md + MEMORY.md)
|
||||
↓ 未命中
|
||||
第二层:wiki_search / wiki_get(编译型知识库检索)
|
||||
↓ 未命中
|
||||
第三层:qmd(QMD 全文检索,已安装 —— 刘总反馈已纳入)
|
||||
↓ 未命中
|
||||
第四层:web_fetch / web_search(外部知识)
|
||||
```
|
||||
|
||||
### 4.2 检索优先级
|
||||
|
||||
1. **memory_search**(corpus=all):首选,零 token 消耗
|
||||
2. **qmd**:本地全文检索,补充 memory_search 未覆盖的长文档
|
||||
3. **wiki_search/wiki_get**:编译型结构化知识库
|
||||
4. **web_search/web_fetch**:外部补充,仅在以上均未命中时使用
|
||||
|
||||
---
|
||||
|
||||
## 五、Token 预算控制
|
||||
|
||||
### 5.1 配置文件大小限制
|
||||
|
||||
| 文件 | 最大行数 | 说明 |
|
||||
|------|----------|------|
|
||||
| AGENTS.md | 200 行 | Agent 协议 + 协作表(精简) |
|
||||
| MEMORY.md | 150 行 | 长期记忆 + 索引表 |
|
||||
| SOUL.md | 80 行 | 角色定义 |
|
||||
| IDENTITY.md | 30 行 | 身份信息 |
|
||||
| USER.md | 30 行 | 用户画像 |
|
||||
| TOOLS.md | 100 行 | 工具索引(不填塞完整参数) |
|
||||
| HEARTBEAT.md | 60 行 | 心跳配置 |
|
||||
|
||||
### 5.2 引用代替填塞
|
||||
|
||||
**反例(填塞模式)**:
|
||||
```markdown
|
||||
# TOOLS.md - 全部填入
|
||||
- memory_search: 参数 query, maxResults, minScore, corpus=[memory|wiki|all|sessions]...
|
||||
(占用大量 token)
|
||||
```
|
||||
|
||||
**正例(引用模式)**:
|
||||
```markdown
|
||||
# TOOLS.md - 索引模式
|
||||
## 已安装 Skills
|
||||
- plantuml-skill → 详见 skills/plantuml-skill/SKILL.md
|
||||
- qmd → 详见 skills/qmd/SKILL.md
|
||||
- ...
|
||||
## 核心工具(已内置于运行时,无需列出参数)
|
||||
- memory_search / wiki_search / web_fetch
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、文档生命周期管理
|
||||
|
||||
### 6.1 状态流转
|
||||
|
||||
```
|
||||
创建 → 草稿(draft) → 审阅中(in_review) → 已批准(approved) → 归档(archived)
|
||||
↓
|
||||
废弃(deprecated)
|
||||
```
|
||||
|
||||
### 6.2 操作规范
|
||||
|
||||
| 操作 | 规则 |
|
||||
|------|------|
|
||||
| 创建 | 在正确目录,按命名规则创建 |
|
||||
| 更新 | 小改动直接覆盖;大改动新建版本 |
|
||||
| 审阅 | 状态标记 `in_review`,通知审阅人 |
|
||||
| 归档 | 移动到 `archive/` 子目录 |
|
||||
| 删除 | 不直接删除,先归档 30 天后清理 |
|
||||
|
||||
### 6.3 版本标记
|
||||
|
||||
- v1.0:首版
|
||||
- v1.1-v1.9:小修
|
||||
- v2.0+:大修 / 重构
|
||||
|
||||
---
|
||||
|
||||
## 七、Agent 端执行规范
|
||||
|
||||
### 7.1 每次任务后
|
||||
1. 更新 `memory/YYYY-MM-DD.md`(日记)
|
||||
2. 如产出文档,更新 MEMORY.md 索引表
|
||||
3. 检查文件名是否符合规范
|
||||
|
||||
### 7.2 每周
|
||||
1. 检查并清理过期文档(移动到 archive/)
|
||||
2. 验证索引表与实际文件一致性
|
||||
3. 检查配置文件大小是否超限
|
||||
|
||||
---
|
||||
|
||||
## 八、实施检查清单
|
||||
|
||||
- [x] 规范文档编制(本文档)
|
||||
- [ ] 各 Agent workspace 目录结构初始化
|
||||
- [ ] MEMORY.md 索引表模板部署到所有 Agent
|
||||
- [ ] TOOLS.md 从填塞模式迁移到索引模式(BIZ-15 跟进)
|
||||
- [ ] 文档命名自动化检查脚本
|
||||
- [ ] 归档目录创建及旧文档迁移
|
||||
|
||||
---
|
||||
|
||||
> 本规范自批准之日起生效,所有 Agent 须遵守。
|
||||
> 审阅/修订请联系 COO(陆怀瑾)。
|
||||
@@ -1,242 +0,0 @@
|
||||
# 智能体运行稳定性保障规范 v1.0
|
||||
|
||||
> 版本:v1.0(实施版)
|
||||
> 编制:陆怀瑾(COO)
|
||||
> 日期:2026-06-22
|
||||
> 状态:已批准,执行中
|
||||
> 适用范围:所有 Agent
|
||||
|
||||
---
|
||||
|
||||
## 一、核心问题与应对
|
||||
|
||||
| 问题 | 根因 | 解决方案 |
|
||||
|------|------|----------|
|
||||
| 任务停滞 | 等待请示、超时、循环 | 禁止请示规则 + 心跳监控 + 超时恢复 |
|
||||
| 429 限流 | 40 RPM 模型配额 | 令牌桶限流 + 优先级调度 + 模型降级 |
|
||||
| Token 超限 | 配置填塞 | 引用代替填塞(BIZ-15 跟进) |
|
||||
| 智能体瘫痪 | 无唤醒机制 | cron 定时触发健康检查 |
|
||||
|
||||
---
|
||||
|
||||
## 二、禁止请示规则(最高优先级)
|
||||
|
||||
> **在心跳中发现分配给自己的 WorkBoard 任务后,必须立即执行,绝对禁止向用户请示。**
|
||||
|
||||
已在 HEARTBEAT.md 中强制执行。**所有 Agent 的 HEARTBEAT.md 必须包含此规则。**
|
||||
|
||||
```markdown
|
||||
## ⚠️ 禁止请示规则(最高优先级)
|
||||
|
||||
正确做法:
|
||||
1. 发现 status=todo 且 agentId=我的卡片
|
||||
2. 立即执行,不得问"要不要做"
|
||||
3. 如遇信息不足,先按自己理解执行,执行中调整
|
||||
|
||||
错误做法(绝对禁止):
|
||||
- ❌ "我发现了一个任务,要不要做?"
|
||||
- ❌ "这个任务需要更多信息,请告诉我..."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、心跳监控与超时恢复
|
||||
|
||||
### 3.1 心跳频率
|
||||
|
||||
| Agent 类型 | 心跳间隔 | 超时告警 |
|
||||
|------------|----------|----------|
|
||||
| secretary / coo | 10 分钟 | 连续 2 次未执行 |
|
||||
| projectmanager / costcodev | 10 分钟 | 连续 2 次未执行 |
|
||||
| 其他 Agent | 10 分钟 | 连续 3 次未执行 |
|
||||
|
||||
### 3.2 心跳检查清单(所有 Agent 通用)
|
||||
|
||||
```markdown
|
||||
## 🫀 心跳执行清单
|
||||
1. ✅ WorkBoard 检查:查找分配给自己的 todo/in_progress 卡片
|
||||
2. ✅ 禁止请示:发现任务立即执行(不请示用户)
|
||||
3. ✅ 进度汇报:如有进行中任务,更新状态
|
||||
4. ✅ 风险上报:识别阻塞、超时问题,通知 COO
|
||||
```
|
||||
|
||||
### 3.3 超时恢复流程
|
||||
|
||||
```
|
||||
Agent 超过 30 分钟无响应
|
||||
↓
|
||||
COO 心跳检测到超时
|
||||
↓
|
||||
记录日志 + 评估任务状态
|
||||
↓
|
||||
┌──────────┴──────────┐
|
||||
│ │
|
||||
任务可恢复 任务不可恢复
|
||||
│ │
|
||||
重新触发任务 通知 Vincent
|
||||
(workboard dispatch) (via session_send)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、429 限流治理
|
||||
|
||||
### 4.1 当前配额与监控
|
||||
|
||||
| 模型 | RPM 限制 | 建议预留 |
|
||||
|------|----------|----------|
|
||||
| 主模型 | 40 | 保留 10 RPM 给紧急任务 |
|
||||
| 备用模型 | 40 | 满 35 RPM 时切换 |
|
||||
|
||||
### 4.2 令牌桶限流策略
|
||||
|
||||
```
|
||||
每个 Agent 独立的令牌桶:
|
||||
- 容量:按 Agent 优先级分配
|
||||
- COO/secretary: 8 RPM
|
||||
- 开发 Agent: 6 RPM
|
||||
- 业务 Agent: 4 RPM
|
||||
- 预留池: 10 RPM (紧急任务)
|
||||
|
||||
令牌桶耗尽 → 自动降级到备用模型或排队
|
||||
```
|
||||
|
||||
### 4.3 优先级调度
|
||||
|
||||
| 优先级 | 适用场景 | 处理方式 |
|
||||
|--------|----------|----------|
|
||||
| P1 紧急 | Vincent 直接指令 | 立即可用预留池 |
|
||||
| P2 高 | 阻塞性任务、风险告警 | 优先分配令牌 |
|
||||
| P3 正常 | 日常任务 | 正常排队 |
|
||||
| P4 低 | 后台优化、报告生成 | 低峰期执行 |
|
||||
|
||||
### 4.4 模型降级链
|
||||
|
||||
```
|
||||
主模型 (qwen3.5-397b) RPM 不足
|
||||
↓
|
||||
备用模型 (deepseek-v4-pro)
|
||||
↓
|
||||
等待 + 指数退避重试 (1s → 2s → 4s → 8s)
|
||||
↓
|
||||
3 次重试后仍失败 → 记录日志,通知 COO
|
||||
```
|
||||
|
||||
### 4.5 请求合并优化
|
||||
|
||||
| 优化项 | 当前做法 | 优化后 |
|
||||
|--------|----------|--------|
|
||||
| WorkBoard 轮询 | 每个 Agent 独立轮询 | COO 统一轮询,广播结果 |
|
||||
| 重复检索 | 多个 Agent 重复查同一文档 | 缓存关键查询结果(5 分钟 TTL) |
|
||||
| 连续调用 | 无间隔连续调用 API | 最小间隔 500ms |
|
||||
|
||||
---
|
||||
|
||||
## 五、唤醒机制
|
||||
|
||||
### 5.1 Cron 定时唤醒
|
||||
|
||||
```yaml
|
||||
# COO 健康检查唤醒
|
||||
cron:
|
||||
schedule: "*/5 * * * *" # 每 5 分钟
|
||||
action: health_check
|
||||
targets:
|
||||
- 检查所有 Agent 最后活跃时间
|
||||
- 超过 15 分钟无活动 → 触发唤醒消息
|
||||
- 超过 30 分钟无活动 → 通知 Vincent
|
||||
```
|
||||
|
||||
### 5.2 唤醒消息模板
|
||||
|
||||
```markdown
|
||||
## 🔔 唤醒检查
|
||||
|
||||
距上次活跃时间:{elapsed} 分钟
|
||||
当前任务状态:{status}
|
||||
是否存在阻塞:{blocked}
|
||||
|
||||
系统自动唤醒,请确认状态。
|
||||
```
|
||||
|
||||
### 5.3 自唤醒规则
|
||||
|
||||
每个 Agent 在 HEARTBEAT.md 中配置:
|
||||
|
||||
```
|
||||
如果距上次心跳超过 2 个周期(20 分钟):
|
||||
→ 自动重新评估任务状态
|
||||
→ 如有待办,立即执行
|
||||
→ 如无待办,确认存活
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、上下文/Token 溢出防护
|
||||
|
||||
### 6.1 配置文件大小限制
|
||||
|
||||
| 文件 | 最大行数 | 超标处理 |
|
||||
|------|----------|----------|
|
||||
| AGENTS.md | 200 | 移到 docs/agent-roster.md |
|
||||
| SOUL.md | 80 | 提取模块化引用 |
|
||||
| TOOLS.md | 100 | 索引化(不填塞参数) |
|
||||
| HEARTBEAT.md | 60 | 精简检查清单 |
|
||||
| MEMORY.md | 150 | 定期归档旧条目 |
|
||||
|
||||
### 6.2 运行时监控
|
||||
|
||||
```
|
||||
Token 使用量达到 80%
|
||||
↓
|
||||
自动清理上下文
|
||||
↓
|
||||
仍超 90%
|
||||
↓
|
||||
重启会话
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、监控告警矩阵
|
||||
|
||||
| 指标 | 警告阈值 | 严重阈值 | 通知对象 |
|
||||
|------|----------|----------|----------|
|
||||
| Agent 无响应 | > 15 min | > 30 min | 警告 → COO,严重 → Vincent |
|
||||
| 429 错误率 | > 5% | > 20% | COO |
|
||||
| Token 使用量 | > 80% | > 95% | 该 Agent |
|
||||
| 任务积压 | > 5 pending | > 10 pending | COO |
|
||||
| 任务超时 | > 24h in_progress | > 48h | 警告 → Agent,严重 → Vincent |
|
||||
|
||||
---
|
||||
|
||||
## 八、实施步骤
|
||||
|
||||
### 阶段 1:即刻生效(今日)
|
||||
- [x] 禁止请示规则 → 已在各 Agent HEARTBEAT.md 中落实
|
||||
- [ ] 心跳频率统一为 10 分钟
|
||||
- [ ] COO 端健康检查 cron 配置
|
||||
|
||||
### 阶段 2:本周完成
|
||||
- [ ] 令牌桶限流配置(按 Agent 分配 RPM)
|
||||
- [ ] 模型降级链配置
|
||||
- [ ] 告警规则上线
|
||||
|
||||
### 阶段 3:持续优化
|
||||
- [ ] 监控面板搭建
|
||||
- [ ] 自动重启恢复
|
||||
- [ ] 请求合并优化
|
||||
|
||||
---
|
||||
|
||||
## 九、交付物清单
|
||||
|
||||
- [x] 运行稳定性保障规范(本文档)
|
||||
- [ ] HEARTBEAT.md 模板更新(含禁止请示 + 自唤醒规则)
|
||||
- [ ] COO 端 cron 健康检查任务
|
||||
- [ ] 令牌桶限流配置
|
||||
- [ ] 告警规则配置
|
||||
|
||||
---
|
||||
|
||||
> 本规范自批准之日起生效。执行中如遇问题,联系 COO(陆怀瑾)。
|
||||
@@ -1,261 +0,0 @@
|
||||
# 智能体知识库体系建设规范 v1.0
|
||||
|
||||
> 版本:v1.0(实施版)
|
||||
> 编制:陆怀瑾(COO)
|
||||
> 日期:2026-06-22
|
||||
> 状态:已批准,执行中
|
||||
> 适用范围:所有 Agent
|
||||
|
||||
---
|
||||
|
||||
## 一、核心目标
|
||||
|
||||
| 目标 | 实现方式 |
|
||||
|------|----------|
|
||||
| 知识与配置解耦 | 知识库独立于 Agent 配置文件,不计入 Token |
|
||||
| Agent 可主动查询 | 通过多层检索体系按需获取知识 |
|
||||
| 人类可审查优化 | Web UI / 飞书文档支持人工审阅 |
|
||||
| 零 Token 增长 | 知识条目独立存储,仅在使用时加载 |
|
||||
|
||||
---
|
||||
|
||||
## 二、分层检索体系(刘总反馈已纳入)
|
||||
|
||||
### 2.1 检索优先级
|
||||
|
||||
```
|
||||
Agent 需要知识
|
||||
↓
|
||||
第一层: memory_search (corpus=all)
|
||||
→ 搜索 memory/*.md + MEMORY.md + wiki 条目
|
||||
→ 零 Token 消耗,语义检索
|
||||
↓ 未命中
|
||||
第二层: wiki_search / wiki_get
|
||||
→ 编译型结构化知识库
|
||||
→ 支持精确检索和页面读取
|
||||
↓ 未命中
|
||||
第三层: qmd (QMD 全文检索,已安装 ← 刘总反馈)
|
||||
→ 本地全文检索 markdown 知识库
|
||||
→ 补充 memory_search 未覆盖的长文档
|
||||
↓ 未命中
|
||||
第四层: web_search / web_fetch
|
||||
→ 外部互联网补充
|
||||
→ 仅在内部均未命中时使用
|
||||
```
|
||||
|
||||
### 2.2 工具速查
|
||||
|
||||
| 工具 | 适用场景 | Token 消耗 |
|
||||
|------|----------|-----------|
|
||||
| memory_search | 通用语义检索(跨 memory + wiki) | 0 |
|
||||
| wiki_search / wiki_get | 结构化知识库精确查询 | 0 |
|
||||
| qmd | 本地全文检索长文档 | 0 |
|
||||
| web_search | 外部互联网信息 | 0 |
|
||||
| web_fetch | 网页/文档详情获取 | 按内容量 |
|
||||
|
||||
---
|
||||
|
||||
## 三、知识库目录结构
|
||||
|
||||
```
|
||||
knowledge/
|
||||
├── 电商/ # 电商运营知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
├── 内容/ # 内容运营知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
├── 产品/ # 产品管理知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
├── 技术/ # 技术开发知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
├── 设计/ # UI/UX 设计知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
├── 运营/ # 通用运营知识
|
||||
│ └── {主题}_v{M}.{N}.md
|
||||
│
|
||||
└── 规范/ # 流程规范知识
|
||||
└── {主题}_v{M}.{N}.md
|
||||
```
|
||||
|
||||
### 知识条目模板
|
||||
|
||||
```markdown
|
||||
# {知识标题}
|
||||
|
||||
> 领域: {所属领域} | 版本: v{M}.{N}
|
||||
> 维护者: {责任人} | 最后更新: {YYYY-MM-DD}
|
||||
|
||||
## 概述
|
||||
{知识的用途和价值,1-2 句话}
|
||||
|
||||
## 适用范围
|
||||
{在什么场景下使用}
|
||||
|
||||
## 核心内容
|
||||
{知识主体}
|
||||
|
||||
## 操作步骤 / SOP
|
||||
1. ...
|
||||
2. ...
|
||||
|
||||
## 质量检查
|
||||
- [ ] ...
|
||||
|
||||
## 常见问题
|
||||
**Q**: ... **A**: ...
|
||||
|
||||
## 相关条目
|
||||
- knowledge/{领域}/{关联主题}.md
|
||||
|
||||
## 版本历史
|
||||
| 版本 | 日期 | 变更 | 作者 |
|
||||
|------|------|------|------|
|
||||
| v1.0 | 2026-06-22 | 初稿 | 陆怀瑾 |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、与 Memory 系统的分工
|
||||
|
||||
| 维度 | Memory 系统 | Knowledge 系统 |
|
||||
|------|------------|---------------|
|
||||
| 内容类型 | 决策记录、经验教训、个性化记忆 | SOP、模板、规范、最佳实践 |
|
||||
| 所有者 | 单个 Agent 专属 | 跨 Agent 共享 |
|
||||
| 更新频率 | 每日/每周 | 按需/按版本 |
|
||||
| 查询方式 | memory_search(语义检索) | wiki_search/wiki_get/qmd |
|
||||
| 存储位置 | MEMORY.md + memory/*.md | knowledge/ 目录 |
|
||||
|
||||
---
|
||||
|
||||
## 五、Agent 查询指南
|
||||
|
||||
### 5.1 何时查询知识库
|
||||
|
||||
| 场景 | 查询示例 |
|
||||
|------|----------|
|
||||
| 执行 SOP 任务 | "淘宝 活动报名 SOP" |
|
||||
| 撰写文档 | "PRD 模板" |
|
||||
| 遇到问题 | "部署 故障排查" |
|
||||
| 制定规范 | "开发规范" |
|
||||
| 不熟悉领域 | "小红书 运营指南" |
|
||||
|
||||
### 5.2 查询标准流程
|
||||
|
||||
```
|
||||
1. 先用 memory_search(corpus=all, query="...") 搜索
|
||||
2. 如有结果,用 memory_get 或 wiki_get 读取详情
|
||||
3. 如无结果,用 qmd 全文检索 knowledge/ 目录
|
||||
4. 仍无结果,记录知识缺口,通知 COO
|
||||
5. 使用获取的知识指导工作
|
||||
```
|
||||
|
||||
### 5.3 知识缺口上报
|
||||
|
||||
```
|
||||
Agent 发现知识缺口
|
||||
↓
|
||||
在 memory/YYYY-MM-DD.md 中记录:
|
||||
- 查询内容
|
||||
- 使用场景
|
||||
- 建议优先级
|
||||
↓
|
||||
通知 COO 创建知识条目
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、人类审查机制
|
||||
|
||||
### 6.1 审查方式
|
||||
|
||||
| 方式 | 适用场景 | 工具 |
|
||||
|------|----------|------|
|
||||
| Obsidian Web UI | 日常浏览、编辑 | wiki_status 确认可用性 |
|
||||
| 飞书文档同步 | 多人协作、审批 | 飞书 Wiki API |
|
||||
| CLI 直接编辑 | 技术人员修改 | write/edit 工具 |
|
||||
|
||||
### 6.2 审核流程
|
||||
|
||||
```
|
||||
Agent 发现缺口 → 记录 → 通知 COO
|
||||
↓
|
||||
COO 评估优先级
|
||||
↓
|
||||
高优先级 → 立即创建/指派
|
||||
低优先级 → 记入 backlog
|
||||
↓
|
||||
创建草稿 → wiki_apply(op="create_synthesis")
|
||||
↓
|
||||
人类审查 → 通过/修改/拒绝
|
||||
↓
|
||||
发布 → 通知相关 Agent
|
||||
```
|
||||
|
||||
### 6.3 定期质量检查
|
||||
|
||||
```bash
|
||||
# 每周运行一次
|
||||
wiki_lint # 检查链接断裂、矛盾信息、过时内容
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、知识条目管理
|
||||
|
||||
### 7.1 创建
|
||||
|
||||
```
|
||||
wiki_apply(op="create_synthesis", title="...", body="...", sourceIds=[])
|
||||
```
|
||||
|
||||
### 7.2 更新
|
||||
|
||||
```
|
||||
wiki_apply(op="synthesis", lookup="...", body="...")
|
||||
```
|
||||
|
||||
### 7.3 版本管理
|
||||
|
||||
| 变更类型 | 版本变化 | 操作 |
|
||||
|----------|----------|------|
|
||||
| 内容微调 | v1.0 → v1.1 | 直接覆盖,更新版本历史 |
|
||||
| 结构性变更 | v1.x → v2.0 | 保留旧版本,新建条目 |
|
||||
| 废弃 | 添加 [deprecated] 标记 | 归档到 archive/ |
|
||||
|
||||
---
|
||||
|
||||
## 八、初始知识基础
|
||||
|
||||
以下条目作为知识库初始基础,需尽快创建:
|
||||
|
||||
| 领域 | 条目 | 优先级 | 负责 Agent |
|
||||
|------|------|--------|-----------|
|
||||
| 电商 | 淘宝运营 SOP | 高 | 陆云帆 |
|
||||
| 电商 | 客服话术模板 | 中 | 陆云帆 |
|
||||
| 内容 | 小红书运营指南 | 高 | 文墨言 |
|
||||
| 内容 | 标题写作技巧 | 中 | 文墨言 |
|
||||
| 产品 | PRD 模板 | 高 | 沈路明 |
|
||||
| 技术 | 开发规范 | 高 | 梁思筑 |
|
||||
| 技术 | 部署流程 | 中 | 严维序 |
|
||||
| 设计 | UI 设计规范 | 中 | 苏锦绘 |
|
||||
| 运营 | KPI 指标定义 | 中 | 陆怀瑾 |
|
||||
| 规范 | 文档存储规范 | 已完成 | 陆怀瑾 |
|
||||
|
||||
---
|
||||
|
||||
## 九、交付物清单
|
||||
|
||||
- [x] 知识库体系建设规范(本文档)
|
||||
- [ ] knowledge/ 目录结构创建
|
||||
- [ ] 初始知识条目(至少 5 个优先)
|
||||
- [ ] Agent 查询指南(已嵌入本文档)
|
||||
- [ ] 知识审核流程(已嵌入本文档)
|
||||
- [ ] wiki_lint 定期检查 cron 任务
|
||||
|
||||
---
|
||||
|
||||
> 本规范自批准之日起生效。知识条目创建请联系 COO 协调。
|
||||
@@ -1,31 +0,0 @@
|
||||
# [知识条目标题]
|
||||
|
||||
## 元数据
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| **领域** | 电商 / 内容 / 产品 / 技术 / 设计 / 运营 / 行政 |
|
||||
| **责任人** | [Agent 名称] |
|
||||
| **版本** | v1.0 |
|
||||
| **创建日期** | YYYY-MM-DD |
|
||||
| **最后更新** | YYYY-MM-DD |
|
||||
| **标签** | [标签1, 标签2, ...] |
|
||||
|
||||
## 概述
|
||||
|
||||
[用 2-3 句话描述本条目的核心内容和使用场景]
|
||||
|
||||
## 正文
|
||||
|
||||
[详细的知识内容,包括步骤、规则、示例等]
|
||||
|
||||
## 相关条目
|
||||
|
||||
- [相关知识条目1](链接)
|
||||
- [相关知识条目2](链接)
|
||||
|
||||
## 变更记录
|
||||
|
||||
| 日期 | 版本 | 变更说明 | 变更人 |
|
||||
|------|------|----------|--------|
|
||||
| YYYY-MM-DD | v1.0 | 初始创建 | [姓名] |
|
||||
Reference in New Issue
Block a user