SuperAPI AI 工具集

group-tech-design

写作与研究

查看项目

更新于 10-16 08:49

技能介绍

用途:帮助用户按标准模板撰写结构化的技术设计文档,然后保存到团队语雀知识库,供组内评审。适用于用户想写技术方案或 RFC 并存入团队库的场景,例如“帮我写技术方案到团队库”“write a tech design for the team”“团队技术方案”。个人库请改用 personal-tech-design。

主要能力:基于 references/template.md 模板填充文档,包含背景、目标、方案设计(架构说明、核心组件职责、数据模型/API 设计、关键流程)、技术选型(含优劣对比表)、方案对比、排期、风险评估、参考资料等章节。生成前可选用 yuque_search 检索相关既有文档,避免重复并引用先前决策;保存时用 yuque_list_repos 定位目标团队知识库,再用 yuque_create_doc 创建文档。

使用方式:需配置 yuque-mcp 服务,使用 yuque_search(可选)、yuque_list_repos、yuque_create_doc 工具。先收集信息:项目/功能名称、背景与问题、目标(必填),约束条件、已有方案(选填),以及团队标识 group login(必填)。若需求模糊,会先提澄清问题。保存示例参数:repo_id 为命名空间(如 my-team/tech-docs),title 为“[技术方案] 项目名称”,format 为 markdown。生成后先给用户审阅,确认后保存,并以草稿状态创建,提示团队评审后发布。

限制:默认用中文书写,除非用户指定英文;团队库需团队级 Token;用户需求含糊时先问 2-3 个针对性问题;发现冲突文档会提示并询问如何协调;创建失败时展示错误并提供手动复制的 markdown;无法修改既有文档,建议新建 v2 或附录。定价、平台范围等细节暂未提供。