技术讨论管理和沉淀

功能概述

标准化管理技术讨论和创意沉淀的技能，帮助自动创建规范的目录结构、讨论记录模板，确保技术知识完整留存。支持 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. 开始开发流程

当用户提到以下关键词时，开始开发流程：

• "开始开发"
• "启动开发"

流程：

1. 列出已完成的讨论
2. 用户选择一个讨论
3. 确认决策文档
4. 确认架构文档
5. 生成开发规划文档
6. 创建代码目录
7. （可选）初始化 Git 仓库
8. （可选）Git 提交所有变更

7. 开发规划文档

开发规划包含：

• 项目信息
• 技术栈
• 开发阶段划分
• 甘特图（Mermaid）
• 里程碑
• 任务清单

8. 记录版本（需 Git）

当用户提到以下关键词时，记录版本：

• "记录版本"
• "版本更新"

注意：此功能需要 Git 支持。

流程：

1. 检查 Git 是否可用
2. 询问版本号（v1.0.0, v1.0.1 等）
3. 询问版本说明
4. Git add 所有变更
5. Git commit
6. Git tag 打版本标签

9. 确认开发完成

当用户提到以下关键词时，确认开发完成：

• "开发完成"
• "确认完成"

10. 讨论结束流程

当用户表示讨论结束时，可以执行：

1. 整理讨论内容，提炼核心结论
2. 更新讨论状态为"已完成"
3. 更新 index.md 索引
4. （可选）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 中维护所有讨论的索引：

# 技术讨论索引