Gitea MCP Tool

# Gitea 项目看板初始化方案 ## 📋 目录 - [工作流方案](#工作流方案) - [看板类型](#看板类型) - [方案与看板的最佳匹配](#方案与看板的最佳匹配) - [扩展场景](#扩展场景) - [实现计划](#实现计划) --- ## 🔄 工作流方案 ### 1. 极简版（3状态） **适用场景**: 个人项目、小团队（1-3人）、快速迭代 **状态流转**: ``` 待办 → 进行中 → 已完成 ``` **特点**: - ✅ 简单直观，零学习成本 - ✅ 适合快速迭代和敏捷响应 - ✅ 减少状态管理开销 - ⚠️ 缺少细粒度追踪 - ⚠️ 不适合复杂项目 **示例场景**: - 个人开源项目 - 原型开发 - 快速修复任务 --- ### 2. 标准版（5状态） **适用场景**: 小型团队（3-10人）、标准开发流程 **状态流转**: ``` 待办事项 → 计划中 → 进行中 → 测试验证 → 已完成 ``` **特点**: - ✅ 平衡了简单性和可追踪性 - ✅ 明确的测试验证环节 - ✅ 适合大多数项目类型 - ✅ 支持基本的质量把控 - ⚠️ 对于复杂项目可能不够细致 **示例场景**: - 标准 Web 应用开发 - 移动应用开发 - 内部工具开发 --- ### 3. 全面版（8状态） **适用场景**: 中大型团队（10-50人）、企业级项目、严格质量要求 **状态流转**: ``` 待办事项 → 需求分析 → 设计评审 → 开发中 → 代码审查 → 测试中 → 预发布 → 已完成 ``` **特点**: - ✅ 完整的软件开发生命周期 - ✅ 多重质量把控点 - ✅ 明确的责任划分 - ✅ 适合合规性要求高的项目 - ⚠️ 流程较重，可能降低速度 - ⚠️ 需要团队培训和适应期 **示例场景**: - 金融系统开发 - 医疗软件开发 - 企业 SaaS 产品 - 大型电商平台 --- ### 4. 敏捷迭代版（6状态） **适用场景**: Scrum/敏捷团队、Sprint 迭代开发 **状态流转**: ``` 待办池 → Sprint待办 → 开发中 → 代码评审 → 测试/验收 → 已完成 ``` **特点**: - ✅ 符合 Scrum 框架 - ✅ 支持 Sprint Planning - ✅ 明确区分 Backlog 和 Sprint - ✅ 适合迭代式交付 - ⚠️ 需要团队遵循敏捷实践 - ⚠️ 对 PO/SM 角色有要求 **示例场景**: - 采用 Scrum 的产品团队 - 2-4 周 Sprint 迭代 - 用户故事驱动开发 --- ## 🎯 看板类型 ### 1. Bug追踪看板 **目的**: 集中管理和追踪软件缺陷 **推荐方案**: 标准版（5状态） **理由**: - Bug 需要明确的测试验证环节 - 不需要需求分析、设计评审等前期阶段 - 需要快速响应，不宜流程过重 **Issue 标签**: - `type/bug` - 缺陷 - `severity/critical` - 严重 - `severity/high` - 高 - `severity/medium` - 中 - `severity/low` - 低 - `priority/P0` - 紧急 - `priority/P1` - 高优先级 - `priority/P2` - 正常 - `priority/P3` - 低优先级 **额外列**: - 待修复 Bug - 修复中 - 待验证 - 已验证 - 已关闭 --- ### 2. 部署实施看板 **目的**: 管理系统部署、上线、发布流程 **推荐方案**: 全面版（8状态） **理由**: - 部署涉及多个环境（开发/测试/预发/生产） - 需要严格的评审和验证 - 风险高，需要多重把控 **Issue 标签**: - `env/dev` - 开发环境 - `env/test` - 测试环境 - `env/staging` - 预发环境 - `env/production` - 生产环境 - `type/deployment` - 部署 - `type/rollback` - 回滚 - `type/migration` - 数据迁移 **额外列**: - 待部署 - 部署方案评审 - 开发环境部署 - 测试环境部署 - 预发环境部署 - 生产环境部署 - 验证监控 - 已完成 --- ### 3. 运维管理看板 **目的**: 日常运维任务、系统维护、监控告警 **推荐方案**: 极简版（3状态）或标准版（5状态） **理由**: - 运维任务需要快速响应 - 流程不宜过重 - 强调执行效率 **Issue 标签**: - `type/incident` - 故障 - `type/maintenance` - 维护 - `type/monitoring` - 监控 - `type/backup` - 备份 - `severity/critical` - 紧急故障 - `severity/high` - 重要维护 - `severity/normal` - 常规任务 **额外列**: - 待处理 - 处理中 - 待验证（可选） - 已完成 --- ### 4. 文档维护看板 **目的**: 管理技术文档、用户手册、API文档的编写和更新 **推荐方案**: 极简版（3状态）或标准版（5状态） **理由**: - 文档类任务流程相对简单 - 主要关注编写和审核 - 不需要复杂的状态流转 **Issue 标签**: - `type/doc-new` - 新文档 - `type/doc-update` - 更新文档 - `type/doc-fix` - 修正文档 - `doc-type/technical` - 技术文档 - `doc-type/user-guide` - 用户手册 - `doc-type/api` - API文档 - `doc-type/architecture` - 架构文档 **额外列**: - 待编写 - 编写中/待审核（可选） - 已完成 --- ### 5. 优化改进看板 **目的**: 代码重构、性能优化、技术债务管理 **推荐方案**: 标准版（5状态）或敏捷迭代版（6状态） **理由**: - 优化需要评估和计划 - 需要测试验证改进效果 - 可能跨多个 Sprint **Issue 标签**: - `type/refactor` - 重构 - `type/performance` - 性能优化 - `type/tech-debt` - 技术债务 - `scope/frontend` - 前端 - `scope/backend` - 后端 - `scope/database` - 数据库 - `scope/infrastructure` - 基础设施 **额外列**: - 优化池 - 计划中 - 开发中 - 测试验证 - 效果评估（可选） - 已完成 --- ## 🎨 扩展场景（超出原始5种） ### 6. 功能开发看板 **目的**: 新功能设计、开发、交付 **推荐方案**: 敏捷迭代版（6状态）或全面版（8状态） **特点**: - 从需求到上线的完整流程 - 支持 Epic → Story → Task 层级 - 适合产品驱动的团队 **Issue 标签**: - `type/feature` - 新功能 - `type/enhancement` - 功能增强 - `size/S` - 小型（1-3天） - `size/M` - 中型（1周） - `size/L` - 大型（2-4周） - `size/XL` - 超大型（1月+） --- ### 7. 测试管理看板 **目的**: 测试用例编写、测试执行、缺陷跟踪 **推荐方案**: 标准版（5状态） **特点**: - 测试计划到执行的完整跟踪 - 区分功能测试、性能测试、安全测试 - 与 Bug追踪看板联动 **Issue 标签**: - `test-type/functional` - 功能测试 - `test-type/performance` - 性能测试 - `test-type/security` - 安全测试 - `test-type/regression` - 回归测试 - `test-phase/unit` - 单元测试 - `test-phase/integration` - 集成测试 - `test-phase/e2e` - 端到端测试 --- ### 8. 安全与合规看板 **目的**: 安全漏洞修复、合规性审查、安全加固 **推荐方案**: 全面版（8状态） **特点**: - 严格的审查流程 - 安全事件快速响应 - 合规性文档跟踪 **Issue 标签**: - `security/vulnerability` - 安全漏洞 - `security/hardening` - 安全加固 - `compliance/gdpr` - GDPR合规 - `compliance/iso27001` - ISO 27001 - `severity/critical` - 严重安全问题 --- ### 9. 研发运营看板（DevOps） **目的**: CI/CD 流水线、基础设施即代码、自动化工具 **推荐方案**: 标准版（5状态）或敏捷迭代版（6状态） **特点**: - 自动化工具开发 - 流水线优化 - 监控和告警配置 **Issue 标签**: - `devops/ci-cd` - CI/CD - `devops/infrastructure` - 基础设施 - `devops/monitoring` - 监控 - `devops/automation` - 自动化 --- ### 10. 客户支持看板 **目的**: 客户反馈、支持工单、功能请求 **推荐方案**: 标准版（5状态） **特点**: - 客户反馈快速响应 - 区分支持工单和功能请求 - SLA 跟踪 **Issue 标签**: - `support/question` - 咨询 - `support/issue` - 问题 - `support/feature-request` - 功能请求 - `priority/sla-critical` - SLA紧急 --- ### 11. 设计与原型看板 **目的**: UI/UX 设计、原型评审、设计系统维护 **推荐方案**: 极简版（3状态）或标准版（5状态） **特点**: - 设计稿迭代 - 原型评审 - 设计组件库管理 **Issue 标签**: - `design/ui` - UI设计 - `design/ux` - UX设计 - `design/prototype` - 原型 - `design-system` - 设计系统 --- ### 12. 数据与分析看板 **目的**: 数据需求、报表开发、数据质量管理 **推荐方案**: 标准版（5状态） **特点**: - 数据需求收集 - 报表和Dashboard开发 - 数据质量监控 **Issue 标签**: - `data/requirement` - 数据需求 - `data/report` - 报表 - `data/dashboard` - Dashboard - `data/quality` - 数据质量 --- ## 🔗 方案与看板的最佳匹配 | 看板类型 | 推荐方案 | 备选方案 | 理由 | |---------|---------|---------|------| | Bug追踪看板 | 标准版(5) | 极简版(3) | 需要测试验证，但不宜过重 | | 部署实施看板 | 全面版(8) | - | 多环境、高风险、需严格把控 | | 运维管理看板 | 极简版(3) | 标准版(5) | 强调快速响应 | | 文档维护看板 | 极简版(3) | 标准版(5) | 流程简单，关注产出 | | 优化改进看板 | 标准版(5) | 敏捷迭代版(6) | 需要计划和验证 | | 功能开发看板 | 敏捷迭代版(6) | 全面版(8) | Sprint驱动或完整SDLC | | 测试管理看板 | 标准版(5) | - | 测试计划到执行 | | 安全合规看板 | 全面版(8) | - | 严格审查流程 | | 研发运营看板 | 标准版(5) | 敏捷迭代版(6) | 自动化和快速迭代 | | 客户支持看板 | 标准版(5) | 极简版(3) | SLA要求和响应速度 | | 设计原型看板 | 极简版(3) | 标准版(5) | 快速迭代设计 | | 数据分析看板 | 标准版(5) | - | 需求到交付 | --- ## 🚀 实现计划 ### MCP 工具设计 ```typescript // 新增工具: gitea_project_board_init { name: "gitea_project_board_init", description: "Initialize a project board with predefined schemes", inputSchema: { owner: string, // 仓库所有者（可选，使用上下文） repo: string, // 仓库名称（可选，使用上下文） boardType: enum, // 看板类型（12种） workflowScheme: enum, // 工作流方案（4种） boardName?: string, // 自定义看板名称 description?: string, // 看板描述 } } ``` ### 交互式选择流程 ``` 1. 选择看板类型（12选1） → Bug追踪看板 → 部署实施看板 → 运维管理看板 → 文档维护看板 → 优化改进看板 → 功能开发看板 → 测试管理看板 → 安全合规看板 → 研发运营看板 → 客户支持看板 → 设计原型看板 → 数据分析看板 2. 选择工作流方案（4选1，根据看板类型推荐） → 极简版（3状态）[推荐用于...] → 标准版（5状态）[推荐用于...] → 全面版（8状态）[推荐用于...] → 敏捷迭代版（6状态）[推荐用于...] 3. 确认配置 看板名称: [自动生成或自定义] 工作流: [选择的方案] 列数: [状态数] 预置标签: [根据看板类型] 4. 生成内容 ✅ 创建项目看板 ✅ 创建看板列 ✅ 创建预置标签 ✅ （可选）创建示例Issue ``` ### 看板导入模板结构 ```json { "name": "Bug追踪看板", "description": "集中管理和追踪软件缺陷", "columns": [ { "title": "待办事项", "sorting": 0 }, { "title": "计划中", "sorting": 1 }, { "title": "进行中", "sorting": 2 }, { "title": "测试验证", "sorting": 3 }, { "title": "已完成", "sorting": 4 } ], "labels": [ { "name": "type/bug", "color": "d73a4a", "description": "Something isn't working" }, { "name": "priority/P0", "color": "b60205", "description": "Critical priority" } ] } ``` --- ## 📚 总结 ### 核心优势 1. **12种预置看板类型**，覆盖软件开发全生命周期 2. **4种工作流方案**，适应不同团队规模和项目复杂度 3. **智能推荐机制**，根据看板类型推荐最佳工作流 4. **开箱即用**，预置标签和列配置 5. **灵活定制**，支持自定义看板名称和描述 ### 下一步 - [ ] 实现 `gitea_project_board_init` MCP 工具 - [ ] 创建 12 种看板类型的模板 JSON - [ ] 实现交互式选择流程（使用 MCP Elicitation API） - [ ] 添加示例 Issue 创建功能 - [ ] 编写使用文档和最佳实践 --- **文档版本**: v1.0 **创建时间**: 2025-11-23 **维护者**: Kysion AI Team