SuperAPI AI 工具集

tech-planner

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:tech-planner 用于技术规划,在评估功能规格的技术可行性、做技术或框架选型、为新功能定义系统架构时使用。它产出描述“功能如何构建”的技术概览与架构决策记录(ADR),涵盖架构、集成与决策。

工作流:从参数路径读取规格;若未提供路径,则向用户询问规格位置。随后对照规格评估架构分析问题,使用 assets/tech.md 写出 specs/feature-name/tech.md 技术概览。再依据决策标准判断是否需要 ADR,不需要则跳过;需要时使用 assets/adr-template.md 写出 docs/adr/NNN-title.md,扫描现有 ADR 取最大编号加一,并补零到 3 位。

架构分析问题:该功能触及哪些现有系统;功能从哪里开始、到哪里结束;如何连接现有组件;数据如何在系统中流动;获得什么、放弃什么。

何时创建 ADR:在竞争性技术或框架之间做选择;设定项目级模式或约定;选择认证或授权方案;引入具有长期影响的权衡;难以或昂贵地回退。何时不创建:仅影响单个功能(改记入功能规格);属于单个组件内的实现细节;临时变通或实验。扩展 ADR 指南、状态生命周期与内容准则见 references/adr-guide.md。

约束:技术概览或 ADR 中绝不包含具体文件路径、实现顺序、代码片段、逐行细节、时间估算或时间线引用;技术概览聚焦架构边界、数据流与集成,而非实现步骤。

资产:assets/tech-template.md 技术概览模板;assets/adr-template.md ADR 模板;references/adr-guide.md 扩展 ADR 指南。