# 上手项目

> 摸清项目里和你的任务相关的那部分。

开始项目任务 · /zh/new-project/ · 2026-11-05

先把 agent 连上 Jira（MCP 或 `acli`）和项目的 Git 托管平台，确认它能读到你的 ticket。本手册里的每个 prompt 都以此为前提。

## 1. 理解业务流程

**Codex**

```text
$neutron:project-discovery 通过已连接的 Jira MCP 或已认证的 acli 读取 [Jira 编号或链接]，包括描述、验收标准和评论。
如果访问不了，就让我把 ticket 内容贴给你。围绕这个任务梳理本项目。
说明谁在用这个功能，一步步讲清业务流程。
画一张简单的流程图，附上相关代码和测试的链接。
列出还没弄清楚的业务问题。先不要改代码。
```

**Claude Code**

```text
/project-discovery 通过已连接的 Jira MCP 或已认证的 acli 读取 [Jira 编号或链接]，包括描述、验收标准和评论。
如果访问不了，就让我把 ticket 内容贴给你。围绕这个任务梳理本项目。
说明谁在用这个功能，一步步讲清业务流程。
画一张简单的流程图，附上相关代码和测试的链接。
列出还没弄清楚的业务问题。先不要改代码。
```

- 弄清谁在用这个功能，他们要完成什么。
- 梳理业务流程，找出你的任务涉及的代码。
- 业务规则不清楚的，找需求负责人确认。
- 把 agent 的总结和待解决的问题作为评论贴到 ticket 上，不要放进仓库；下一步从这里接着做。

## 2. 在本地运行项目

**Prompt**

```text
按本项目的 AGENTS.md、文档索引和环境搭建说明，在本地把项目搭起来。只用测试凭据和测试服务。
启动应用，跑 [改动涉及的部分] 的测试。汇报你执行的命令、原本就失败的测试，以及没能解决的环境问题。
不要禁用检查，也不要改应用代码。
```

- 仓库的 `AGENTS.md` 和文档索引你自己也要读；它们告诉你和你的 agent 这个项目怎么运作。
- 确认本地运行不会发出真实消息、发放奖励或写入生产环境。
- 记下改动之前就失败的测试，免得之后算到你头上。

## 3. 选好分支和 PR 目标分支

- 按[分支策略](/zh/branching-strategy/)选好起始分支和目标版本。
- 切分支之前，先让 agent 确认这个计划。改动和它的测试放在同一个 ticket 分支上。

## 4. 确认权限和评审人

- 确认需求找谁澄清、PR 由谁评审，以及项目的发布 runbook 放在哪里。
- 只给 agent 开发环境的权限。生产环境操作和破坏性操作需要[有人明确同意](/zh/security/#r-ai-2)。

下一步：带上 ticket 和梳理笔记，进入[交付改动](/zh/deliver-a-change/)。