# Neutron 工程手册

> Neutron 工程师如何借助 AI agent 构建软件：我们坚持的规则、从 ticket 到发布的工作流程，以及防范高代价错误的工程防护。

每个页面在路径后加 .md 即可获得 Markdown 版本。要求有固定编号（例如 VAL-3），所有要求及其风险和检查方式都在 /requirements.json。英文版：/llms.txt。

## 基础

- [规则](/zh/index.md)
- [用 AI agent 开发](/zh/agent-development.md): 把问题讲清楚，让 agent 去调查、提出建议，并证明结果成立。

## 开始项目任务

- [上手项目](/zh/new-project.md): 摸清项目里和你的任务相关的那部分。
- [分支策略](/zh/branching-strategy.md): 弄清从哪里拉分支、合并到哪里、最终发布什么。

## 开发与评审

- [交付改动](/zh/deliver-a-change.md): 把一个 Jira ticket 变成测试过、可以评审的改动。
- [代码评审](/zh/code-review.md): 核对结果，处理 review 意见，批准最终要合并的改动。

## 部署与发布

- [发布与收尾](/zh/release-mgmt.md): 不管客户的流程是什么，都要发布你验证过的那个版本，想好怎么撤销，并让文档如实反映现状。

## 运维与恢复

- [调查与恢复](/zh/incidents.md): 找到证据，止损，恢复受影响的流程和记录。

## 工程防护

- [访问、密钥与数据](/zh/security.md): 防止越权访问、数据泄露，以及改错环境。
- [数据库变更](/zh/migrations.md): 改表结构期间，旧代码照常运行。
- [资金与奖励](/zh/value-abuse.md): 防止重复发放、无上限发放，以及对不上账的余额。
- [后台任务与外部调用](/zh/jobs.md): 进程崩溃、任务重试之后，该做的事不丢；调用外部服务时不卡死、不刷爆、不重复。
- [短信、OTP 与付费接口](/zh/otp.md): 在滥用请求变成账单之前拦住它们。
- [安全验收（SSAT）](/zh/ssat.md): 上线或大版本发布前，逐项用证据核对 SSAT。

## Optional

- [Full text](/zh/llms-full.txt)
- [Requirements](/requirements.json)