Agent Skills › Tencent/LoopForge › tech-design

tech-design

GitHub

根据需求输入自动生成结构完整的技术方案 Markdown 文档。支持解析报告或口头描述,按需追问细节,基于模板生成含 Mermaid 图表的方案并保存文件。

local/.cursor/skills/tech-design/SKILL.md Tencent/LoopForge

触发场景

帮我写技术方案 出一个技术设计文档 写一份 design doc 给这个需求出方案

安装

npx skills add Tencent/LoopForge --skill tech-design -g -y
更多选项

非标准路径

npx skills add https://github.com/Tencent/LoopForge/tree/main/local/.cursor/skills/tech-design -g -y

不安装直接使用

npx skills use Tencent/LoopForge@tech-design

指定 Agent (Claude Code)

npx skills add Tencent/LoopForge --skill tech-design -a claude-code -g -y

安装 repo 全部 skill

npx skills add Tencent/LoopForge --all -g -y

预览 repo 内 skill

npx skills add Tencent/LoopForge --list

SKILL.md

Frontmatter
{
    "name": "tech-design",
    "description": "通用技术方案撰写技能。根据需求输入(需求分析报告或口头描述)自动生成结构完整的技术方案 Markdown 文档。当用户说\"帮我写技术方案\"、\"出一个技术设计文档\"、\"写一份 design doc\"、\"给这个需求出方案\"时使用本技能。"
}

技术方案撰写技能

工作流程

第一步:解析需求输入

根据输入类型进行处理:

  • 需求分析报告:读取报告文件,提取需求背景、功能点、约束条件
  • 口头描述:直接理解用户描述,若信息不足以支撑方案撰写,追问以下关键信息:
    • 核心功能是什么?
    • 涉及哪些系统/模块?
    • 有无性能/安全特殊要求?
    • 预计数据量级?

第二步:加载方案模板

读取通用技术方案模板:references/general.md

第三步:撰写技术方案

按照模板结构生成技术方案,注意:

  • 架构图、流程图、时序图统一使用 Mermaid 语法绘制
  • 不涉及的章节(如灰度策略、第三方依赖)直接删除,不强行填写
  • 若某章节信息不足,标注"待补充"并说明需要哪些信息
  • 方案中的估算数据(性能指标、数据量等)需标注来源或假设依据

第四步:保存文档

将生成的技术方案保存为 Markdown 文件:

  • 若用户已指定输出路径,保存到指定路径
  • 若用户未指定路径,询问保存位置
  • 文件名建议:tech-design-[需求名称].md

注意事项

  • 方案内容应具体、可落地,避免空泛描述
  • 关键技术决策需说明"为什么选这个,为什么不选那个"
  • 复杂方案优先用图表表达,文字辅助说明

版本历史

  • dd56585 当前 2026-11-16 13:50

同 Skill 集合

local/.claude/skills/agent-observability/SKILL.md
local/.claude/skills/brainstorming/SKILL.md
local/.claude/skills/knowledge-distillation/SKILL.md
local/.claude/skills/tech-design/SKILL.md
local/.claude/skills/writing-plans/SKILL.md
local/.codebuddy/skills/agent-observability/SKILL.md
local/.codebuddy/skills/brainstorming/SKILL.md
local/.codebuddy/skills/knowledge-distillation/SKILL.md
local/.codebuddy/skills/tech-design/SKILL.md
local/.codebuddy/skills/writing-plans/SKILL.md
local/.codex/skills/devflow-codex/SKILL.md
local/.codex/skills/knowledge-distillation/SKILL.md
local/.codex/skills/superpowers/brainstorming/SKILL.md
local/.cursor/skills/agent-observability/SKILL.md
local/.cursor/skills/brainstorming/SKILL.md
local/.cursor/skills/knowledge-distillation/SKILL.md
local/.cursor/skills/writing-plans/SKILL.md
local/skills/devflow-clarify-requirements/SKILL.md
local/skills/devflow/SKILL.md
skills/report-workflow-usage/SKILL.md

元信息

文件数
0
版本
777f16a
Hash
8792846f
收录时间
2026-11-16 13:50

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-16 20:33
浙ICP备14020137号-1