Index of every page on this site: llms.txt
All skills
tencent avatar

/tech-design

@5fadefc
by tencenttencent/loopforge5.2k stars
722
Run it yourself

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

Use this Skill: https://skilld.dev/gh/tencent/loopforge/tech-design

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈76 tokens for metadata: the name and description. ≈357 when used: this file. ≈986 more on demand in 1 file.

Description uses 1.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈130 characters, or 1.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

技术方案撰写技能

工作流程

第一步:解析需求输入

根据输入类型进行处理:

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

第二步:加载方案模板

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

第三步:撰写技术方案

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

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

第四步:保存文档

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

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

注意事项

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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill automates the generation of technical design documents based on user-provided requirements. While functionally safe, it possesses a standard indirect prompt injection surface because it processes external files (requirement reports) without specific sanitization or boundary markers, which could allow malicious instructions within those files to influence the agent's output.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at 5fadefc. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 17 hours ago.

Activeupdated last month

README badge

README badge for tencent/loopforge/tech-design