用途:生成简洁的技术规格(tech spec)文档,聚焦描述变更内容(WHAT),而非实现细节,用 PlantUML 图表和简短说明表达。适用于用户提出设计功能、计划变更、记录实现前方案,或需要在团队内沟通设计决策时。
主要能力:按固定结构组织文档,包含 Infrastructure(API 端点、权限、定时任务)、Model(PlantUML 类图)、Flow(活动图/时序图)、Happy path(简要描述或测试场景)、Backwards compatibility(如需要)等章节;支持新表完整字段列表和用 ... 表示未变字段。
使用方式:先收集需求(标题、受影响服务、关键变更如 API、数据库、业务流、前端),再套用模板结构撰写各节,PlantUML 写在代码块内;保存时执行 mkdir -p resource/tech-spec,写入 resource/tech-spec/<tech-spec-title>.md(kebab-case),并返回文件路径。
关键规则:不写文件结构对比、不写文件映射表、不写导入更新策略、不写代码示例、不写清单、不写逐步实现指令;每条保持一两句话,复杂流程用图。范围控制:超过 3 个服务、8 个模型变更或 4 个复杂流程时考虑拆分。
限制:资料未提供该技能的具体平台兼容性、收费或价格信息;部分流程需人工补充需求细节。