# Project_Workflow_Agent

**Repository Path**: huiwings/project_-workflow_-agent

## Basic Information

- **Project Name**: Project_Workflow_Agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AgentOS

AgentOS 是一套面向软件工程任务的多 Agent 协作配置。它将需求分析、代码检索、实现、Review 和测试拆分给职责独立的 Agent，由 Master Orchestrator 按标准工作流统一调度。

当前仓库实现的是 **Claude Code 适配层**。`docs.md` 描述整体设计，`.claude/` 提供可加载的 Agent、工程规范、输出模板和工作流配置。

## 设计原则

- 理解需求和现有实现后再修改。
- 优先采用最小修改和最小影响方案。
- 一个 Agent 只承担一种主要职责。
- 实现必须经过独立 Review，适用时必须测试。
- Prompt、工程规范和输出模板分离维护。
- 所有结论区分事实、假设和待验证项。

## 系统架构

```text
User
  |
  v
Master Orchestrator
  |
  v
Planner
  |
  +-- Information Gathering: Searcher / Code Reader
  +-- Implementation: Coder / Frontend / Backend / Document Writer
  +-- Design: Architecture / API Designer
  +-- Validation: Reviewer / Tester / Specialized Reviewers
```

Master 只负责接收需求、调度、流程控制和结果汇总，不直接承担编码、Review 或测试。

## 目录结构

```text
.
|-- README.md
|-- docs.md
|-- .gitignore
`-- .claude/
    |-- CLAUDE.md
    |-- agents/       # 14 个专业 Agent
    |-- standards/    # 9 份共享工程规范
    |-- templates/    # 6 个结构化输出模板
    `-- docs/         # 工作流、职责矩阵和项目规则
```

关键入口：

- `.claude/CLAUDE.md`：Master 调度规则和职责边界。
- `.claude/docs/workflow.md`：唯一工作流定义、返工和停止条件。
- `.claude/docs/agent-map.md`：Agent 职责与权限矩阵。
- `.claude/docs/project-rules.md`：规则优先级和项目级约束。
- `.claude/standards/`：编码、Review、测试、安全、数据库等共享规范。
- `.claude/templates/`：Planner、实施、Review、测试等输出模板。

## Agent 与模型

模型能力顺序为 `fable > opus > sonnet > haiku`。当前配置按职责复杂度分配：

| 模型 | Agent | 主要职责 |
| --- | --- | --- |
| `fable` | planner | 需求、影响、风险和工作流规划 |
| `fable` | architecture | 架构边界、依赖和方案设计 |
| `fable` | reviewer | 综合正确性与回归审查 |
| `fable` | security-reviewer | 安全专项审查 |
| `fable` | api-designer | API 契约和兼容性设计 |
| `opus` | coder | Bug 修复和局部功能实现 |
| `opus` | frontend | 前端局部实现 |
| `opus` | backend | 后端局部实现 |
| `opus` | performance-reviewer | 性能专项审查 |
| `sonnet` | searcher | 文件、符号和引用定位 |
| `sonnet` | code-reader | 调用链、数据流和业务流程分析 |
| `sonnet` | tester | 功能、边界、异常和回归验证 |
| `sonnet` | database-reviewer | 数据库专项审查 |
| `haiku` | document-writer | 基于已验证事实更新文档 |

模型名称必须由实际运行环境支持。如果环境中的模型标识不同，需要同步调整 `.claude/agents/*.md` 的 `model` 字段。

## 工作流

Planner 根据任务类型选择下列一种主流程：

| 任务类型 | 流程 |
| --- | --- |
| 阅读代码 | Planner -> Searcher -> Code Reader -> Master |
| Bug 修复 | Planner -> Searcher -> Code Reader -> Implementation -> Reviewer -> Tester -> Master |
| 小功能 | Planner -> Code Reader -> Implementation -> Reviewer -> Tester -> Master |
| Code Review | Planner -> Reviewer -> Master |
| 测试失败 | Planner -> Tester -> Reviewer -> Master |
| 架构设计 | Planner -> Architecture -> Reviewer -> Master |

其中 Implementation 默认由 Coder 承担，也可以按变更领域替换为 Frontend、Backend 或 Document Writer。专项 Reviewer 可按安全、数据库或性能风险加入流程，但不能替代核心 Reviewer。

详细返工、测试豁免和停止条件以 `.claude/docs/workflow.md` 为准。

## 使用方式

### 前置条件

1. 安装支持项目级 Agent 配置的 Claude Code。
2. 确认运行环境支持配置中的 `fable`、`opus`、`sonnet` 和 `haiku` 模型标识。
3. 在本项目根目录启动 Claude Code。

Claude Code 加载 `.claude/CLAUDE.md` 后，Master 会先委派 Planner，再按任务类型调度对应 Agent。

示例请求：

```text
阅读用户登录模块，说明认证调用链和异常处理。
```

```text
修复订单重复提交问题，保持现有 API 兼容并完成回归验证。
```

```text
Review 当前变更，优先检查正确性、安全和回归风险。
```

## 自定义配置

- 调整模型：修改对应 `.claude/agents/<agent>.md` 的 `model` 字段。
- 调整职责：修改 Agent 文件，并同步检查 `.claude/docs/agent-map.md`。
- 调整流程：只在 `.claude/docs/workflow.md` 中修改，避免产生多个流程来源。
- 增加工程约束：优先扩展 `.claude/standards/`，不要在多个 Agent Prompt 中复制规则。
- 调整输出：修改 `.claude/templates/` 中的对应模板。

修改后应确认 Agent 权限仍满足最小权限原则，且实施者不能 Review 或批准自己的产出。

## 静态验证

在 PowerShell 中可以执行：

```powershell
$files = Get-ChildItem .claude -Recurse -File
$files.Count
$files | Where-Object Length -eq 0
rg -n "^(name|model):" .claude/agents
```

当前预期结果：

- `.claude/` 下共有 33 个非空 Markdown 文件。
- `agents/` 下共有 14 个 Agent，名称唯一。
- 所有 Agent frontmatter 均包含 `name`、`description`、`tools` 和 `model`。
- `.claude/...` 内部文件引用均可访问。

## 兼容性与限制

- 当前仅提供 Claude Code 目录和 frontmatter，未实现 Codex CLI、Gemini CLI、Cursor 或 Cline 的原生入口。
- Bash 的只读或测试边界同时依赖 Agent 规则和宿主环境的权限审批、沙箱策略。
- 仓库提供的是协作配置，不包含具体业务应用、构建脚本或应用级测试。

## 设计文档

完整的设计目标、分层、职责矩阵和演进路线参见 [`docs.md`](docs.md)。