SuperAPI AI 工具集

apply-yliu-product-development-practices

编程与开发

查看项目

更新于 10-16 05:01

技能介绍

用途:在创建或修改应用时应用 Yliu 的产品开发实践,覆盖开发前确认、项目初始化、技术选型、前后端实现、页面交互、测试和交付前验证。

决策顺序:先执行用户本次明确要求;用户未指定时沿用项目已稳定使用的方案;两者都无答案时才采用本技能默认做法。新项目可直接采用;旧项目默认渐进适配,仅新代码用新做法,被修改的旧代码可顺手调整,其余保持不动,只有用户明确要求全面重构才统一迁移。仅当用户明确说明项目处于开发阶段或要求从零实现某功能时,才视为开发阶段,不凭版本号或代码成熟度推测。

工作流程:先查看任务、现有代码、依赖、脚本和配置,理解目标与约束,明确可验证结果;能确认的信息不重复询问,关键歧义先澄清,低风险细节自行判断并说明假设。写代码前先看项目内可否复用,再评估成熟社区方案,采用满足需求的最简单实现。默认沿用项目风格,只做当前任务所需改动。按改动范围和风险验证,失败则继续定位修正,完成时说明验证结果与未验证部分。

按需读取规范:涉及目标用户、设备主题、初始化、端口、包管理、Monorepo、Git hook、技术选型等读 project-and-architecture.md;涉及 TypeScript、修改范围、代码清理、注释、Hook、Composable、组件抽象读 implementation-practices.md;涉及接口、请求、路由、页面数据、Loading、错误反馈、危险操作、样式读 requests-routing-and-ui.md;涉及数据库、ORM、数据验证、统一响应、Swagger、时间、环境变量、后端日志、生产编排读 backend-data-and-runtime.md;涉及测试、类型检查、Lint、格式化、构建、验证读 testing-and-validation.md。多面任务读取所有相关规范,普通任务无需加载全部。

核心原则:先复用项目已有能力,再评估社区方案,都不合适才自行实现;同构项目优先复用语言、类型和验证规则;页面只管理自己的请求,跨页面核心状态优先放入 URL;请求失败必须进入错误流程,Loading 尽量只影响对应区域;不增加未要求的功能、配置或扩展;只测试重要且稳定的行为,检查力度与改动风险一致。

限制:本技能提供默认选择,不覆盖用户要求,不强迫旧项目全面迁移;具体规范文件内容、安装方式与平台支持暂未提供。