llm-to-agent/docs/features/project-assistant.md
2026-08-21 16:33:23 +08:00

58 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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并展示外部结果。
- 所有对外写操作进入统一确认和审计流程。