# 产品研发规范库

本库包含产品、界面、业务与工程规范。先根据当前任务选择相关文档，再读取对应 Markdown 原文。通用建议应结合项目实际情况使用；项目本地约定和用户要求优先。

完整目录：/index.json

## 指南
### 开始使用
- [如何使用产品研发规范库](/content/guide/usage/how-to-use-this-library.md): 这份指南面向产品、设计、研发人员和 Agent，说明如何查找、判断并应用本库的研发规范。

## 产品
### 需求与验收
- [需求定义与验收](/content/product/requirements/requirements-and-acceptance.md): 本规范用于把一个产品想法转成团队可以实现和验收的需求。

## 界面
### 设计原则
- [UI 设计哲学：让内容与行动成为主角](/content/ui/philosophy/ui-design-philosophy.md): 这套原则用于产品研发中的工作台、工具、后台和内容界面。

### 界面基础
- [界面基础规范](/content/ui/foundations/interface-foundations.md): 本规范用于产品研发中的页面与组件设计。

## 业务
### 规则与数据
- [业务规则与数据边界](/content/business/rules/business-rules-and-data.md): 本规范用于梳理业务流程中的事实、权限和状态变化。

## 工程
### 项目与架构
- [现代 TypeScript 项目启动](/content/engineering/foundations/modern-typescript-project.md): 创建一个能持续演进、又不提前膨胀为平台的紧凑项目。
- [通用工程边界](/content/engineering/foundations/engineering-boundaries.md): 本参考适用于任何有实现工作的项目，不依赖 Agent、短信登录、特定框架或多服务部署。
- [简洁 TypeScript 项目蓝图](/content/engineering/foundations/project-blueprint.md): 这是一份可复用的决策指南，而非必须照搬的脚手架。
- [技术选型与落地](/content/engineering/foundations/technology-selections.md): 本参考给出新 TypeScript 全栈项目的推荐基线。

### 后端设计
- [软件设计哲学：降低复杂度的开发规范](/content/engineering/backend/software-design-philosophy.md): 在完成用户需求的同时，让开发者理解一次操作时需要知道的事情更少，让一个设计决策的变化影响更小。
- [设计示例与反例](/content/engineering/backend/design-examples.md): 以下是为本规范编写的工程示例，不是书中案例。
- [来源与适用说明](/content/engineering/backend/sources.md): 主要来源：John Ousterhout《A Philosophy of Software Design》，原技能作者使用的中文翻译站点(https://cactus-proj.github.io/A-Philosophy-of-Software-Design-zh/preface.html)。

### 性能与资源
- [性能研发规范](/content/engineering/performance/performance-principles.md): 本规范适用于产品的页面、接口、后台任务和资源交付。
- [静态资源与对象存储](/content/engineering/performance/static-assets.md): 本规范适用于网站图片、字体、音视频、附件及运行时生成文件。

### 协作与交付
- [AGENTS.md 项目规范](/content/engineering/workflow/agents-md-standard.md): 每个项目必须在仓库根目录提供 AGENTS.md。
- [工程文档体系](/content/engineering/workflow/documentation-system.md): 工程文档的作用是让下一次改动能找到当前事实、关键约束和已验证证据，不是为每次任务生成一套设计报告。
- [Git、资源与持久化](/content/engineering/workflow/git-repository-and-assets.md): 本参考用于新建仓库、设计 .gitignore、处理图片／文件或决定业务数据存放位置。
- [团队 Git 协作](/content/engineering/workflow/team-git-collaboration.md): 本参考用于多人在同一仓库或多个相关仓库中开发、验证和交付改动。

### 专题实践
- [单 Agent 与受控工具](/content/engineering/extensions/agent-runtime.md): 本参考适用于产品确实需要一个可调用业务能力的对话 Agent。
- [新通短信登录](/content/engineering/extensions/xintong-sms-identity.md): 本参考用于负责人明确要求在新项目中接入与 Study Buddy 相同的新通手机号验证码登录时。
- [IELTS Buddy 的扩展工程经验](/content/engineering/extensions/ieltsbuddy-development-experience.md): 本参考从 IELTS Buddy 的当前工程约定、架构快照、能力契约和发布／可观测性文档中提炼。