技术讨论管理和沉淀
功能概述
标准化管理技术讨论和创意沉淀的技能，帮助自动创建规范的目录结构、讨论记录模板，确保技术知识完整留存。支持 Git 版本管理作为可选增强功能。
核心功能
- 📝 标准化技术讨论记录模板
- 📂 自动创建关联代码输出目录
- 🔄 自动维护讨论索引
- 🤝 多智能体协同支持
- 🔍 便于后续检索和回顾
- 🌿 Git 版本管理（可选增强）
- 📋 决策文档和架构文档生成
- 📅 开发规划生成（含甘特图）
- 🏷️ 版本记录和标签管理（需 Git）
Git 增强功能（可选）
- 💡 说明：Git 是可选增强功能，不影响基础功能使用
- ✅ 有 Git 时：自动启用版本管理、自动提交、标签管理
- ❌ 无 Git 时：所有基础功能正常使用，仅跳过 Git 相关操作
智能体使用规范
当用户发起技术讨论时，智能体推荐按照以下流程执行：
1. 讨论启动流程
当用户提到以下关键词时，可以触发技能：
- "我们讨论一下..."
- "技术方案评审"
- "需求评审"
- "架构设计讨论"
- "创意 brainstorm"
- "记录一下这个讨论"
注意： 也可以直接在当前对话中记录讨论，不强制使用技能。
自动执行以下操作：
我已经帮你创建了技术讨论记录：
📝 讨论文件：`projects/tech-discussion-manager/docs/discussions/YYYY-MM-DD-主题.md`
📂 代码目录：`projects/tech-discussion-manager/code-output/[主题]/`
我们可以开始讨论了，我会实时记录要点和决策。
2. 讨论记录格式
建议按照以下结构记录：
# [主题] 技术方案讨论
时间：YYYY-MM-DD HH:MM
参与方：{{PARTICIPANTS}}
状态：进行中 / 已完成
标签：{{TAGS}}
## 讨论背景
[自动填充讨论背景]
## 讨论要点
- [ ] 要点1：xxx
- [ ] 要点2：xxx
## 决策结论
- 结论1：xxx，原因：xxx
- 结论2：xxx，原因：xxx
## 待办事项
- [ ] 任务1：xxx，负责人：xxx，截止时间：xxx
- [ ] 任务2：xxx，负责人：xxx，截止时间：xxx
## 相关产出
- 代码输出：`projects/tech-discussion-manager/code-output/[主题]/`
- 文档：`projects/tech-discussion-manager/docs/`
- 参考链接：
3. 列出讨论列表
当用户提到以下关键词时，列出所有讨论：
输出格式：
📋 技术讨论列表
## 已完成
- [2026-04-04] GEO工具架构设计 ✅
- [2026-04-03] 数据库选型讨论 ✅
## 进行中
- [2026-04-04] API接口设计 🔄
4. 生成决策文档
当用户提到以下关键词时，生成决策文档：
5. 生成架构文档
当用户提到以下关键词时，生成架构文档：
6. 开始开发流程
当用户提到以下关键词时，开始开发流程：
流程：
- 列出已完成的讨论
- 用户选择一个讨论
- 确认决策文档
- 确认架构文档
- 生成开发规划文档
- 创建代码目录
- （可选）初始化 Git 仓库
- （可选）Git 提交所有变更
7. 开发规划文档
开发规划包含：
- 项目信息
- 技术栈
- 开发阶段划分
- 甘特图（Mermaid）
- 里程碑
- 任务清单
8. 记录版本（需 Git）
当用户提到以下关键词时，记录版本：
注意：此功能需要 Git 支持。
流程：
- 检查 Git 是否可用
- 询问版本号（v1.0.0, v1.0.1 等）
- 询问版本说明
- Git add 所有变更
- Git commit
- Git tag 打版本标签
9. 确认开发完成
当用户提到以下关键词时，确认开发完成：
10. 讨论结束流程
当用户表示讨论结束时，可以执行：
- 整理讨论内容，提炼核心结论
- 更新讨论状态为"已完成"
- 更新
index.md 索引
- （可选）Git 提交变更
11. 目录结构规范
$OPENCLAW_WORKSPACE/
└── projects/
└── tech-discussion-manager/
├── .git/ # Git 仓库（可选）
├── .gitignore # Git 忽略文件
├── docs/ # 所有文档
│ ├── discussions/ # 讨论记录
│ │ └── YYYY-MM-DD-主题.md
│ ├── decisions/ # 决策文档
│ │ └── [项目名]-decision.md
│ ├── architecture/ # 架构文档
│ │ └── [项目名]-architecture.md
│ ├── dev-plans/ # 开发规划
│ │ └── [项目名]-plan.md
│ └── index.md # 讨论索引
└── code-output/ # 代码输出
└── [项目名]/
├── .gitignore
├── README.md
└── [代码文件]
12. 讨论索引维护
在 projects/tech-discussion-manager/docs/index.md 中维护所有讨论的索引：
# 技术讨论索引
## 进行中
| 日期 | 主题 | 状态 | 标签 |
|------|------|------|------|
| YYYY-MM-DD | 主题名称 | 进行中 | xxx |
## 已完成
| 日期 | 主题 | 决策摘要 | 标签 |
|------|------|----------|------|
| YYYY-MM-DD | 主题名称 | 决策简述 | xxx |
记忆系统集成
本技能作为可选工具提供：
- 推荐使用本技能管理技术讨论（但不强制）
- 讨论记录默认保存到
projects/tech-discussion-manager/docs/（可自定义位置）
- 也可以直接在当前对话中记录，不强制使用技能
- 所有讨论结构化留存，便于后续检索
- Git 版本管理为可选增强功能
Git 使用说明（可选）
Git 可用性检查
使用前先检查 Git 是否可用：
- 可用：自动启用 Git 相关功能
- 不可用：跳过 Git 操作，基础功能正常使用
初始化 Git 仓库（可选）
首次使用且 Git 可用时，可自动执行：
git init
git add .
git commit -m "初始化 tech-discussion-manager 项目"
自动提交（可选）
Git 可用时，每次生成或修改文档时自动提交：
- 新建讨论：
新增讨论: [主题]
- 更新决策：
更新决策文档: [项目名] v1.0 -> v1.1
- 生成规划：
新增开发规划: [项目名]
版本标签（可选，需 Git）
使用 Git tag 标记版本：
git tag -a v1.0.0 -m "版本 v1.0.0"
与其他技能的关系
- 本技能专注于讨论记录和知识沉淀
- 代码产出可以配合其他技能（如 code generator）使用
- 决策文档可以配合文档类技能使用
- Git 版本管理为可选增强，与其他 Git 工具兼容
用户使用示例
基础模式（无 Git）
用户：我们讨论一下GEO工具的架构设计
智能体：✅ 已创建技术讨论记录：
📝 讨论文件：projects/tech-discussion-manager/docs/discussions/2026-04-02-geo工具架构设计.md
📂 代码目录：projects/tech-discussion-manager/code-output/geo工具架构设计/
请开始讨论，我会实时记录要点。
---
用户：讨论结束
智能体：好的，已整理讨论结论：
📝 讨论文件：projects/tech-discussion-manager/docs/discussions/2026-04-02-geo工具架构设计.md
📝 索引已更新：projects/tech-discussion-manager/docs/index.md
增强模式（有 Git）
用户：我们讨论一下GEO工具的架构设计
智能体：✅ 已创建技术讨论记录：
📝 讨论文件：projects/tech-discussion-manager/docs/discussions/2026-04-02-geo工具架构设计.md
📂 代码目录：projects/tech-discussion-manager/code-output/geo工具架构设计/
🌿 Git 已提交：新增讨论: geo工具架构设计
请开始讨论，我会实时记录要点。
---
用户：讨论结束
智能体：好的，已整理讨论结论：
📝 讨论文件：projects/tech-discussion-manager/docs/discussions/2026-04-02-geo工具架构设计.md
📝 索引已更新：projects/tech-discussion-manager/docs/index.md
🌿 Git 已提交
---
用户：开始开发
智能体：📋 已完成的讨论列表：
1. [2026-04-02] GEO工具架构设计
2. [2026-04-01] 数据库选型
请选择要开发的讨论（输入序号）：
用户：1
智能体：✅ 已选择讨论：GEO工具架构设计
📝 生成决策文档...
📝 生成架构文档...
📝 生成开发规划...
📂 创建代码目录...
🌿 初始化 Git 仓库...
✅ 所有变更已提交到 Git
开发规划已生成：projects/tech-discussion-manager/docs/dev-plans/geo工具-plan.md
代码目录：projects/tech-discussion-manager/code-output/geo工具/
---
用户：记录版本
智能体：请输入版本号（例如 v1.0.0）：
用户：v1.0.0
智能体：请输入版本说明：
用户：初始版本发布
智能体：✅ 版本 v1.0.0 已记录
🌿 Git commit: v1.0.0 - 初始版本发布
🏷️ Git tag: v1.0.0
