【用途】 本技能用于全栈项目的技术栈选型与术语解释。当用户要为全栈项目选技术栈、比较某一层的候选方案(ORM、前端框架、API 风格、部署目标等)、判断一组技术能否共存、查版本兼容性、解释全栈术语,或需求变更后需要评估“继续 / 降级 / 换栈”时使用。覆盖 TypeScript 与 Python 两条轨。
【边界】 做:选型、候选比较、组合兼容性判定、版本兼容查证、术语解释、开发中因需求变更而评估“继续 / 降级 / 换栈”。 不做:需求澄清与需求拷打对齐、架构设计、写代码、代码审查。判据是:如果一件事的答案不取决于“选哪套技术”,就不属于本技能。
【三条原则】
- 版本号一律现查现证:技能不含任何版本号,查法见 references/version-verification.md,每次选型都要把命令与输出写进 docs/stack/version-evidence.md。
- 区分“技术硬约束”与“生态惯例”:只有官方文档证实的不兼容才是硬约束;脚手架或社区的常见搭配不算。判定标准见 references/constraints-typescript.md 与 references/constraints-python.md 的分层说明。
- 给排序候选组合,让用户选:不替用户拍板,不只给一个默认栈,每个候选组合给出理由与代价。
【流程】 阶段一 · 锁定选型前提:只问会改变选型的硬事实。必问项包括部署目标与运行环境(自有服务器 / 云托管 / 边缘 / Serverless)、数据规模与并发量与数据敏感性、团队既有技能、必须对接的外部服务;按需追加预算与时间线、是否要桌面端/移动端、是否多租户、是否要离线。用 ask 工具一次问完,每题给“无偏好 / 不关心”出口。完成标准是拿到足以把候选集收窄到 2–3 套的硬事实;仍无法收窄时说明缺哪条事实、会导致什么分歧,按最保守假设继续并标注。
阶段二 · 给候选组合 + 解释术语:按用户语言选轨,读对应 constraints 文件,生成 2–3 套覆盖所有层的完整候选组合。每套给出每层选型(具体到库)、理由、代价、排序依据。术语解释首次出现时用四段式(专业词、一句白话、为什么影响你、常见误用),只解释影响当前决策的术语,不一次倾倒全部。
阶段三 · 出决策表并落盘:用户选定后,按 references/artifacts.md 格式写 docs/stack/decision.md 与 docs/stack/version-evidence.md,在使用方项目 AGENTS.md 追加 stack 小节指向决策表(先检查避免重复),并告知用户复核时机。版本查证在写决策表之前做,查不到官方兼容声明的层标“未查得官方声明”。
【开发中复核】 需求变更可能撞上选型前提时启动:读决策表找出被触及的层,给出“继续 / 降级 / 换栈”三个选项并各写明代价,用户选定后把结论追加进 docs/stack/change-impact.md(新开一份不覆盖历史)。复核只评估选型影响,不动手改业务代码。
【参考文件】 references/constraints-typescript.md(TS 轨层候选、硬约束、生态惯例)、references/constraints-python.md(Python 轨同上)、references/version-verification.md(npm / PyPI 版本与兼容性查证)、references/glossary.md(术语四段式条目)、references/artifacts.md(产物格式)、references/templates/(可复制模板)。
【常见失误】 凭记忆给版本号;把脚手架偏好说成硬约束;候选组合留空层;术语倾倒;反复解释用户已懂的东西。
【限制】 该技能不负责需求梳理、架构设计与代码实现,也不含版本表;具体版本与兼容性需现查,查不到官方声明的部分只能标注为未查得。收费、平台等信息暂未提供。