规范目录

产品研发规范库

产品 · 界面 · 业务 · 工程

指南

找到并正确使用规范

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 的当前工程约定、架构快照、能力契约和发布／可观测性文档中提炼。