# Project 开发助手

## 项目上下文与规则

**实现阶段：P2**

- 读取项目说明、目录结构、已有开发规则和构建配置。
- 将相关 Project 上下文装配给 Coding Behavior，而不是一次性塞入全部源码。
- 支持用户维护项目专属指令，并在 Run 中显示实际采用的规则。

## 仓库理解与代码检索

**实现阶段：P2**

- 浏览仓库结构、搜索符号与文本、定位入口和相关测试。
- 形成面向当前需求的结构概览，避免为每次任务预先建立重型索引。
- 在修改前识别影响范围、现有约定和可能的验证方式。

## 代码修改与 Diff

**实现阶段：P2**

- 使用文件与补丁 Tool 修改源码，处理多文件改动和冲突。
- 持续展示工作区状态和 Diff，并关联每次修改的需求与 Run。
- 保持用户已有未提交改动，不用破坏性 Git 操作覆盖现场。

## Build、Test、Lint 与验证

**实现阶段：P2**

- 发现或配置项目验证命令，运行构建、测试、Lint 和类型检查。
- 解析退出状态和关键失败，允许 Agent 修正后重新验证。
- 汇总执行过的验证、未执行项和剩余风险。

## 单 Agent 开发闭环

**实现阶段：P2**

- 跑通“理解需求 → 阅读源码 → 修改 → 验证 → 汇报”的完整流程。
- 在普通非自身项目中验证该闭环后，才允许用于 System Evolution。
- 最终回答包含改动摘要、验证结果、Diff 位置和需要用户决定的问题。

## Git 与 Worktree 工作流

**实现阶段：P2**

- 支持 status、diff、log、branch 和隔离 worktree 的创建、使用、检查与清理。
- 候选开发默认在 worktree 中进行，稳定工作区保持可用。
- Git 写操作通过明确的工作流执行，不让模型随意拼接高影响命令。

## 远程仓库、PR 与 CI

**实现阶段：P7**

- 读取远程 Issue、PR、Review 和 CI 状态，将其转换为本地开发上下文。
- 支持创建提交、推送分支、创建或更新 PR，并展示外部结果。
- 所有对外写操作进入统一确认和审计流程。