Tech Design — Technical Design Document Generator (Team)

When to Use

• User wants to write a technical design document or RFC and save it to the group repo
• User says "帮我写技术方案到团队库", "write a tech design for the team", "团队技术方案"
• User describes a feature/system and needs it formalized into a design doc for group review

Required MCP Tools

yuque-mcp

• yuque_search

  — (Optional) Search for related existing docs for context

• yuque_list_repos

  — Find the target group knowledge base

• yuque_create_doc

  — Create the design document

Reference

Workflow

Step 1: Understand the Requirements

• "这个功能要解决什么问题？"
• "有什么技术约束吗？比如必须用某个框架、要兼容现有系统？"
• "预期的时间节点是什么？"

Step 2: (Optional) Search for Context

Tool: yuque_search
Parameters:
  query: "<related keywords>"
  type: "doc"

• Avoid duplicating existing designs
• Reference prior decisions
• Understand the current architecture

Step 3: Generate the Design Document

references/template.md

1. 背景 (Background) — Problem statement, current situation
2. 目标 (Goals) — What this design achieves, non-goals
3. 方案设计 (Design) — The core technical approach
   • Architecture diagram description (describe in text/ASCII if needed)
   • Core components and their responsibilities
   • Data model / API design
   • Key flows (sequence of operations)
4. 技术选型 (Tech Stack) — Why specific technologies were chosen
5. 方案对比 (Alternatives) — Other approaches considered and why they were rejected
6. 排期 (Timeline) — Milestones and estimated effort
7. 风险评估 (Risks) — What could go wrong and mitigation strategies
8. 参考资料 (References) — Related docs, links, prior art

Step 4: Review with User

• "方案内容是否准确？有需要调整的地方吗？"
• "要补充其他技术细节吗？"

Step 5: Save to Team Yuque

Tool: yuque_list_repos
Parameters:
  login: "<group_login>"
  type: "group"

Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"    # e.g., "my-team/tech-docs"
  title: "[技术方案] <项目名称>"
  body: "<formatted design document>"
  format: "markdown"

Step 6: Confirm

✅ 技术方案已创建（草稿状态）！

📄 **[[技术方案] 项目名称](文档链接)**
📚 已保存到：「团队知识库名称」

### 文档结构
- 背景与目标
- 方案设计（含 X 个核心模块）
- 技术选型对比
- 排期（预计 X 周）
- 风险评估（X 个风险点）

💡 文档为草稿状态，请团队评审后发布。

Guidelines

• Write the design doc in Chinese (default) unless the user specifies English
• Be specific in the design section — include data models, API signatures, flow descriptions
• For tech stack comparison, use a table with pros/cons
• Keep the document actionable — someone should be able to implement from this doc
• If the user's requirements are vague, make reasonable assumptions and note them clearly with "【假设】" markers
• Don't over-engineer — match the design complexity to the project scope
• Always end the confirmation with "请团队评审后发布" — group designs need review
• This skill saves to group repos — for personal repos, use the

  tech-design

  skill in the

  yuque-personal

  plugin

Error Handling

yuque_search

yuque_create_doc

yuque_search