build-maintainable-app
Installation
SKILL.md
构建可维护的应用
采用本技能的构建约定,把成果做成开发者和 Agent 能继续维护的项目。这些是本技能的默认选择,具体框架、平台及实施范围服从用户要求和现有工程。
先确定本次交付范围
区分当前任务是修订技能或规约、准备工程骨架,还是实现应用。用户要求先打磨规则时,只修改规则及隔离试用材料;应用改造留到后续实施任务。骨架阶段如实保留业务功能和运行验收的未完成状态。
实施应用时,读取入口、项目清单、构建、测试和项目约定,确认交付平台、关键交互与数据流。已有工程保留业务行为和未完成工作,迁移按本次范围推进;局部修复不顺带重建工程或升级整个工具链。
在业务扩展前建立基线
新项目从适用的官方脚手架开始;整理原型时先在临时目录生成官方模板作比较基线,保留标准入口和配置分工。新建 Web 使用 TypeScript,其他平台沿用其原生类型与工具体系。
从官方资料核对当前稳定版本、运行时要求与依赖兼容性,记录实际选择及锁文件。框架支持的例外需要具体理由,不把历史版本号写成永久规则,也不为了使用最高版本号引入预览版。
新建 Web 或约定迁移工程基线时,在扩展业务页面前先读取并落实 Web 工程基线。 起点包括严格类型与静态检查、格式配置、可安装且有效的提交前检查、多语言入口、亮色/暗色/跟随系统、可扩展主题和用户偏好,以及多设备下可操作的代表性界面。只安装依赖、声明变量或留下待办不算这些能力已接通。已有项目的普通功能修改沿用当前工程约定,未纳入任务的基线缺口只作说明,不因此扩大改造。
先用一个最小可运行界面验证这些机制,再复用它增加业务。新项目的基线缺失时先补齐当前基础;已有工程的差距按迁移范围说明,不用“后续统一优化”替代已经纳入任务的要求。