Skip to content

qqxb-qqqf / website

Go to a project
Commit c651a08f by yangzehui
Options

更新规范

parent 520578a3
Inline Side-by-side
Showing with 112 additions and 44 deletions
.obsidian/plugins/obsidian-git/data.json 0 → 100644
{
"commitMessage": "",
"autoCommitMessage": "vault backup: {{date}}",
"commitMessageScript": "",
"commitDateFormat": "YYYY-MM-DD HH:mm:ss",
"autoSaveInterval": 0,
"autoPushInterval": 0,
"autoPullInterval": 0,
"autoPullOnBoot": false,
"autoCommitOnlyStaged": false,
"disablePush": false,
"pullBeforePush": true,
"disablePopups": false,
"showErrorNotices": true,
"disablePopupsForNoChanges": false,
"listChangedFilesInMessageBody": false,
"showStatusBar": true,
"updateSubmodules": false,
"syncMethod": "merge",
"mergeStrategy": "none",
"customMessageOnAutoBackup": false,
"autoBackupAfterFileChange": false,
"treeStructure": true,
"refreshSourceControl": true,
"basePath": "",
"differentIntervalCommitAndPush": false,
"changedFilesInStatusBar": false,
"showedMobileNotice": true,
"refreshSourceControlTimer": 7000,
"showBranchStatusBar": true,
"setLastSaveToLastCommit": false,
"submoduleRecurseCheckout": false,
"gitDir": "",
"showFileMenu": true,
"authorInHistoryView": "full",
"dateInHistoryView": true,
"diffStyle": "split",
"hunks": {
"showSigns": false,
"hunkCommands": false,
"statusBar": "disabled"
},
"lineAuthor": {
"show": false,
"followMovement": "inactive",
"authorDisplay": "initials",
"showCommitHash": false,
"dateTimeFormatOptions": "date",
"dateTimeFormatCustomString": "YYYY-MM-DD HH:mm",
"dateTimeTimezone": "viewer-local",
"coloringMaxAge": "1y",
"colorNew": {
"r": 255,
"g": 150,
"b": 150
},
"colorOld": {
"r": 120,
"g": 160,
"b": 255
},
"textColorCss": "var(--text-muted)",
"ignoreWhitespace": false,
"lastShownAuthorDisplay": "initials",
"lastShownDateTimeFormatOptions": "date"
}
}
\ No newline at end of file
.obsidian/workspace.json
...@@ -25,14 +25,14 @@ ...@@ -25,14 +25,14 @@
"id": "9e12cc0466efde53", "id": "9e12cc0466efde53",
"type": "leaf", "type": "leaf",
"state": { "state": {
"type": "split-diff-view", "type": "markdown",
"state": { "state": {
"aFile": "Claude.md.md", "file": "使用说明.md.md",
"bFile": "Claude.md.md", "mode": "source",
"aRef": "" "source": false
}, },
"icon": "diff", "icon": "lucide-file",
"title": "Diff: Claude.md (Working Tree)" "title": "使用说明.md"
} }
} }
], ],
...@@ -169,13 +169,13 @@ ...@@ -169,13 +169,13 @@
"state": { "state": {
"type": "outline", "type": "outline",
"state": { "state": {
"file": "未命名.md", "file": "Claude.md.md",
"followCursor": false, "followCursor": false,
"showSearch": false, "showSearch": false,
"searchQuery": "" "searchQuery": ""
}, },
"icon": "lucide-list", "icon": "lucide-list",
"title": "未命名 的大纲" "title": "Claude.md 的大纲"
} }
}, },
{ {
...@@ -193,7 +193,7 @@ ...@@ -193,7 +193,7 @@
} }
], ],
"direction": "horizontal", "direction": "horizontal",
"width": 300 "width": 297.5
}, },
"left-ribbon": { "left-ribbon": {
"hiddenItems": { "hiddenItems": {
...@@ -208,7 +208,7 @@ ...@@ -208,7 +208,7 @@
"obsidian-git:Open Git source control": false "obsidian-git:Open Git source control": false
} }
}, },
"active": "9e12cc0466efde53", "active": "6b81636547946e8d",
"lastOpenFiles": [ "lastOpenFiles": [
"Claude.md.md", "Claude.md.md",
"使用说明.md.md", "使用说明.md.md",
......
Claude.md.md
...@@ -109,7 +109,7 @@ ...@@ -109,7 +109,7 @@
| 产品单元 | 一块独立、完整、能自己闭环的产品功能，对外只暴露一份契约（目的/输入/输出/触发/边界），由 2–3 人小组负全责 | | 产品单元 | 一块独立、完整、能自己闭环的产品功能，对外只暴露一份契约（目的/输入/输出/触发/边界），由 2–3 人小组负全责 |
| 事实源 | 即 `产品现状/` 目录，当前有效规则与逻辑的唯一可信来源 | | 事实源 | 即 `产品现状/` 目录，当前有效规则与逻辑的唯一可信来源 |
| 入库 | 文件提交进本仓库并 push。只有入库的才算团队成果，聊天记录里的产出不算 | | 入库 | 文件提交进本仓库并 push。只有入库的才算团队成果，聊天记录里的产出不算 |
| 产品单元负责人 | 负责冲突处理、MR 评审、规范抽查、每周核对的角色 | | 产品单元负责人 | 负责冲突处理、需求逻辑评审、规范抽查、每周核对的角色 |
| 亲亲企服 | 面向企业的服务平台（平台底座 + 官网 + 客户端） | | 亲亲企服 | 面向企业的服务平台（平台底座 + 官网 + 客户端） |
| 亲亲小保 | 面向个人的事业发展顾问(面向灵活就业者、自由职业者、想搞副业的人)。 | | 亲亲小保 | 面向个人的事业发展顾问(面向灵活就业者、自由职业者、想搞副业的人)。 |
| 自动申报员 | RPA 底座之上的社保/公积金申报自动化产品 | | 自动申报员 | RPA 底座之上的社保/公积金申报自动化产品 |
......
使用说明.md.md
# 产品单元知识库 · 使用说明 # 产品单元知识库 · 使用说明
# 产品单元知识库 · 使用说明 # 产品单元知识库 · 使用说明
> 状态：草稿 ｜ 维护人：杨泽辉 ｜ 日期：2026-07-22 本文档是给人看的入口。AI 的工作约定见根目录 `CLAUDE.md`（工具自动加载，请勿手改）。 > 状态：已审核 ｜ 维护人：杨泽辉 ｜ 日期：2026-07-22 本文档是给人看的入口。AI 的工作约定见根目录 `CLAUDE.md`（工具自动加载，请勿手改）。
--- ---
...@@ -9,26 +9,26 @@ ...@@ -9,26 +9,26 @@
本库是一个**产品单元**的唯一事实源与团队记忆。三句话记住它的用法： 本库是一个**产品单元**的唯一事实源与团队记忆。三句话记住它的用法：
- 查「**现在的规则是什么**」→ 只看 `产品现状/` - 查「**现在的规则是什么**」→ 只看 `产品现状/`
- 查「**这次要改什么**」→ 看 `需求及UI设计/` 下【进行中】的版本目录 - 查「**这次要改什么**」→ 看 `工作规划/`和 `需求及UI设计/` 下【进行中】的版本目录
- 查「**当初为什么这么定**」→ 翻 `决策记录/` 和 `会议纪要/` - 查「**当初为什么这么定**」→ 翻 `决策记录/` 和 `会议纪要/`
我们的工作方式：**AI 承担产出**（文档、原型、代码、测试的初稿），**人承担判断**（对不对、能不能用、该不该上）。所以这个库既是给人看的档案，也是 AI 干活的上下文——库的质量直接决定 AI 产出的质量。 我们的工作方式：**AI 承担产出**（文档、原型、代码、测试的初稿），**人承担判断**（对不对、能不能用、该不该上）。所以这个库既是给人看的档案，也是 AI 干活的上下文——库的质量直接决定 AI 产出的质量。
## 2. 目录速览 ## 2. 目录速览
|目录 / 文件|放什么|维护人| | 目录 / 文件 | 放什么 | 维护人 |
|---|---|---| | ------------ | ------------------------------------------------------------------- | ------------- |
|`CLAUDE.md`|AI 工作指令，工具自动加载|产品单元负责人，勿手改| | `CLAUDE.md` | AI 工作指令，工具自动加载 | 杨泽辉，勿手改 |
|`使用说明.md`|本文档|产品单元负责人| | `使用说明.md` | 本文档 | 杨泽辉 |
|`产品现状/`|当前有效的全部规则与流程（唯一可信）：产品概述、业务规则（一条一文件、带编号）、核心流程|产品单元负责人| | `产品现状/` | 当前有效的全部规则与流程（唯一可信）：产品概述、业务规则（一条一文件、带编号）、核心流程 | 产品单元负责人 |
|`工作规划/`|什么时间完成什么，用版本号串起需求与设计|产品单元负责人| | `工作规划/` | 什么时间完成什么，用版本号串起需求与设计 | 产品单元负责人 |
|`需求及UI设计/`|按版本建目录，如 `V2.0（2026-06-20）【进行中】/`：PRD、HTML 原型、UI 设计图（只存设计平台链接）、相关物料|产品经理 + UI 设计师| | `需求及UI设计/` | 按版本建目录，如 `V2.0（2026-06-20）【进行中】/`：PRD、HTML 原型、UI 设计图（只存设计平台链接）、相关物料 | 产品经理 + UI 设计师 |
|`系统设计/`|技术方案|研发负责人| | `系统设计/` | 技术方案 | 研发负责人 |
|`测试/`|测试用例与记录|研发负责人| | `测试/` | 测试用例与记录 | 研发负责人 |
|`决策记录/`|决策档案，按 `_模版.md` 写，**只增不改**|全员均可新增| | `决策记录/` | 决策档案，按 `_模版.md` 写，**只增不改** | 全员均可新增 |
|`会议纪要/`|会议档案，按 `_模版.md` 写，**只增不改**|全员均可新增| | `会议纪要/` | 会议档案，按 `_模版.md` 写，**只增不改** | 全员均可新增 |
|`个人工作/{姓名}/`|个人过程产物、AI 探索性草稿|每位成员| | `个人工作/{姓名}/` | 个人过程产物、AI 探索性草稿 | 每位成员 |
|`附件/`|压缩后的图片、物料等非文本附件|全员| | `附件/` | 压缩后的图片、物料等非文本附件 | 全员 |
**个人工作/ 与正式目录的关系**：没确认的东西先放自己名下的文件夹；经确认要成为单元成果的，才移入对应正式目录。正式目录里不应出现半成品。 **个人工作/ 与正式目录的关系**：没确认的东西先放自己名下的文件夹；经确认要成为单元成果的，才移入对应正式目录。正式目录里不应出现半成品。
...@@ -58,7 +58,7 @@ ...@@ -58,7 +58,7 @@
2. **同步纪律**：开工先 Pull，收工必 Push；commit 前逐文件预览 diff 2. **同步纪律**：开工先 Pull，收工必 Push；commit 前逐文件预览 diff
3. **事实源唯一**：只存结论不存过程，每条规则带编号、生效日期、来源链接 3. **事实源唯一**：只存结论不存过程，每条规则带编号、生效日期、来源链接
4. **需求与事实源的边界**：需求 = 增量（这次改什么），事实源 = 全量（现在是什么）；需求验收通过时，规则条目合并进产品现状，版本目录标注【已完成并归档】 4. **需求与事实源的边界**：需求 = 增量（这次改什么），事实源 = 全量（现在是什么）；需求验收通过时，规则条目合并进产品现状，版本目录标注【已完成并归档】
5. **评审机制**：`产品现状/` 和 `决策记录/` 的变更必须走 GitLab MR，reviewer 批准后合并；其余目录初期可直推 5. **评审机制**：`产品现状/` 和 `决策记录/` 的变更必须由产品负责人确认；其余目录初期可直推
6. **只增不改**：见铁律二 6. **只增不改**：见铁律二
7. **状态标记**：所有文档头部标注 `状态：草稿/已审 + 审核人 + 日期`；AI 产出一律先标草稿 7. **状态标记**：所有文档头部标注 `状态：草稿/已审 + 审核人 + 日期`；AI 产出一律先标草稿
8. **会议入库标准**：产生决策、变更规则、或分配带截止日期任务的会议才入库，「结论」为必填项 8. **会议入库标准**：产生决策、变更规则、或分配带截止日期任务的会议才入库，「结论」为必填项
...@@ -67,25 +67,25 @@ ...@@ -67,25 +67,25 @@
## 6. 角色分工 ## 6. 角色分工
|角色|职责| | 角色 | 职责 |
|---|---| | ------- | ---------------------------------------------------------------- |
|产品单元负责人|对单元目标、计划、交付负全责；维护产品现状与工作规划；晨会发言、周会汇报；处理冲突、MR 评审、规范抽查、发起每周 AI 核对| | 产品单元负责人 | 对单元目标、计划、交付负全责；维护产品现状与工作规划；晨会发言、周会汇报；处理冲突、需求逻辑评审、规范抽查、发起每周 AI 核对 |
|产品负责人|需求分析、产品设计、原型与 UI、验收标准、对接业务与事实源| | 产品负责人 | 需求分析、产品设计、原型与 UI、验收标准、对接业务与事实源 |
|研发负责人|技术方案、开发实现、测试联调、质量与运行环境| | 研发负责人 | 技术方案、开发实现、测试联调、质量与运行环境 |
## 7. 常用操作对照 ## 7. 常用操作对照
|我想……|怎么做| | 我想…… | 怎么做 |
|---|---| | ------------- | ------------------------------------------------ |
|了解产品现在的规则|读 `产品现状/`，或直接问 Cowork（它以产品现状为准）| | 了解产品现在的规则 | 读 `产品现状/`，或直接问 Cowork（它以产品现状为准） |
|开一版新需求|在 `需求及UI设计/` 建 `V{x.x}（日期）【进行中】/`，让 AI 按模板起草 PRD| | 开一版新需求 | 在 `需求及UI设计/` 建 `V{x.x}（日期）【进行中】/`，让 AI 按模板起草 PRD |
|记录一个决策|复制 `决策记录/_模版.md`，填全必填项（尤其「需更新的事实源文件」），入库| | 记录一个决策 | 复制 `决策记录/_模版.md`，填全必填项（尤其「需更新的事实源文件」），入库 |
|整理会议纪要|把录音转写稿丢给 Cowork，按 `会议纪要/_模版.md` 提炼，人确认后入库| | 整理会议纪要 | 把录音转写稿丢给 Cowork，按 `会议纪要/_模版.md` 提炼，人确认后入库 |
|需求验收通过了|规则条目合并进 `产品现状/`（走 MR），版本目录改标【已完成并归档】| | 需求验收通过了 | 规则条目合并进 `产品现状/`，版本目录改标【已完成并归档】 |
|找某条规则当初为什么这么定|看规则条目里的来源链接 → 对应决策记录| | 找某条规则当初为什么这么定 | 看规则条目里的来源链接 → 对应决策记录 |
|看某文件的修改历史|GitHub Desktop → History 标签| | 看某文件的修改历史 | GitHub Desktop → History 标签 |
## 8. 新成员接入清单 ## 8. 成员接入清单
1. 找 IT 申请 VPN 账号（注明需访问 GitLab），安装客户端，验证能打开 GitLab 页面 1. 找 IT 申请 VPN 账号（注明需访问 GitLab），安装客户端，验证能打开 GitLab 页面
2. 安装 Git + GitHub Desktop，clone 本仓库到统一路径 `~/Work/{仓库名}` 2. 安装 Git + GitHub Desktop，clone 本仓库到统一路径 `~/Work/{仓库名}`
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment