产品研发规范库
规范目录
产品研发规范库
产品 · 界面 · 业务 · 工程
搜索规范
指南
找到并正确使用规范
1 篇
开始使用
1 篇
如何使用产品研发规范库
这份指南面向产品、设计、研发人员和 Agent,说明如何查找、判断并应用本库的研发规范。
产品
需求与验收
1 篇
需求与验收
1 篇
需求定义与验收
本规范用于把一个产品想法转成团队可以实现和验收的需求。
界面
视觉与交互
2 篇
设计原则
1 篇
UI 设计哲学:让内容与行动成为主角
这套原则用于产品研发中的工作台、工具、后台和内容界面。
界面基础
1 篇
界面基础规范
本规范用于产品研发中的页面与组件设计。
业务
规则与流程
1 篇
规则与数据
1 篇
业务规则与数据边界
本规范用于梳理业务流程中的事实、权限和状态变化。
工程
架构、实现与交付
16 篇
项目与架构
4 篇
现代 TypeScript 项目启动
创建一个能持续演进、又不提前膨胀为平台的紧凑项目。
通用工程边界
本参考适用于任何有实现工作的项目,不依赖 Agent、短信登录、特定框架或多服务部署。
简洁 TypeScript 项目蓝图
这是一份可复用的决策指南,而非必须照搬的脚手架。
技术选型与落地
本参考给出新 TypeScript 全栈项目的推荐基线。
后端设计
3 篇
软件设计哲学:降低复杂度的开发规范
在完成用户需求的同时,让开发者理解一次操作时需要知道的事情更少,让一个设计决策的变化影响更小。
设计示例与反例
以下是为本规范编写的工程示例,不是书中案例。
来源与适用说明
主要来源:John Ousterhout《A Philosophy of Software Design》,原技能作者使用的中文翻译站点(https://cactus-proj.github.io/A-Philosophy-of-Software-Design-zh/preface.html)。
性能与资源
2 篇
性能研发规范
本规范适用于产品的页面、接口、后台任务和资源交付。
静态资源与对象存储
本规范适用于网站图片、字体、音视频、附件及运行时生成文件。
协作与交付
4 篇
AGENTS.md 项目规范
每个项目必须在仓库根目录提供 AGENTS.md。
工程文档体系
工程文档的作用是让下一次改动能找到当前事实、关键约束和已验证证据,不是为每次任务生成一套设计报告。
Git、资源与持久化
本参考用于新建仓库、设计 .gitignore、处理图片/文件或决定业务数据存放位置。
团队 Git 协作
本参考用于多人在同一仓库或多个相关仓库中开发、验证和交付改动。
专题实践
3 篇
单 Agent 与受控工具
本参考适用于产品确实需要一个可调用业务能力的对话 Agent。
新通短信登录
本参考用于负责人明确要求在新项目中接入与 Study Buddy 相同的新通手机号验证码登录时。
IELTS Buddy 的扩展工程经验
本参考从 IELTS Buddy 的当前工程约定、架构快照、能力契约和发布/可观测性文档中提炼。