架构与概念
了解JARFIS核心架构：编排模型、11个Agent、9阶段Phase流水线、3个Human Gate、状态管理以及学习系统。
最后更新: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
JARFIS如何通过结构化Phase协调AI Agent——从Triage到Retrospective，在每个关键决策节点都有人类监督。
JARFIS哲学
JARFIS建立在一套基础原则之上，这些原则指导着每一个设计决策，从Agent行为到Phase转换。这些原则不是抽象的理想，而是嵌入系统中的强制约束。
Principle Zero
"哲学优先于实现"
九大原则
指导系统所有设计决策的9个核心原则：
P1
Orchestration for All
Core
P2
Token Austerity
Quality
P3
Self-Evolution
Evolution
P4
Dialectic Quality
Quality
P5
AI-Native Artifacts
Evolution
P6
Abstraction over Memorization
Evolution
P7
Deterministic Foundation
Quality
P8
Human Gate, AI Execute
Core
P9
Resilient Continuity
Resilience
建设性张力
原则之间存在着有意为之的张力关系。这种平衡使系统保持健康：
P3 Self-Evolution
P8 Human Gate
自主进化 vs 人类控制节点
P2 Token Austerity
P3 Self-Evolution
节省token vs 为学习投入
P4 Dialectic Quality
P1 Orchestration for All
批判性质量 vs 可访问性简化
编排模型
JARFIS遵循Phase门控编排模型。工作流经顺序Phase流转，在关键决策节点设有Human Gate。编排器负责管理状态转换和Agent激活。
TriagePre-flightDiscoveryGate 1ArchUXGate 2ImplOpsReviewGate 3Retro
编排模型的核心特性：
- 顺序Phase — 每个Phase必须完成后下一个才能开始
- 条件执行 — Phase 3（UX）仅在需要UI变更时运行；Phase 4.5（Ops）仅在基础设施变更时运行
- 基于类型的路由 — Type A（简单修复）直接跳到Phase 4；Type B（中等）从Phase 1开始；Type C（复杂）经过完整流水线
- Gate可逆性 — 人类可以在任何Gate将工作退回到之前的Phase
11个Agent角色
每个Agent都是具有明确职责的专业角色，仅在当前Phase需要其专业知识时才被激活。Agent分为四个类别：
规划 & 设计 Agent
PO
Product Owner
逆向提问明确意图、Working Backwards新闻稿、PRD撰写、范围协调
AR
Architect
可行性评估、影响分析、架构设计、ADR（架构决策记录）撰写
TL
Tech Lead
API规范审查、任务分解、代码审查主导、Retrospective主持
UX
UX Designer
界面设计、交互设计、SVG资产制作、设计令牌（条件执行——仅在需要UI时）
实现 Agent
BE
Backend Engineer
服务端实现、数据库Schema、API端点、业务逻辑
FE
Frontend Engineer
客户端实现、组件、状态管理、UX实现
DO
DevOps/SRE
基础设施、CI/CD流水线、部署配置、监控搭建
质量 & 审查 Agent
QA
QA Engineer
测试策略、测试实现、QA验证、覆盖率分析
SE
Security Engineer
威胁建模、预审安全分析、安全审查、合规检查
辩证 Agent
ADV
Advocate
为提议的解决方案辩护，捍卫权衡决策，呈现利益
CRT
Critic
质疑假设，识别风险和弱点，提出替代方案
9阶段Phase流水线
包含各Phase职责和Gate位置的完整流水线：
T
Triage
将请求分类为Type A（简单）、B（中等）或C（复杂）。决定执行哪些Phase。
0
Pre-flight
Git同步、创建分支、加载学习文件（全局学习 + 项目上下文）、验证环境。
1
Discovery
PO进行逆向提问，撰写Working Backwards文档和PRD。Architect评估可行性。
Gate 1
批准 / 修改 / 中止
2
Architecture & Planning
影响分析、架构设计、API规范、任务分解、测试策略。关键决策进行ADV/CRT辩证讨论。
3
UX Design
界面设计、SVG资产、设计令牌。条件执行——仅在需要UI变更时运行。
Gate 2
批准 / 修改 / 中止
4
Implementation
BE/FE/DevOps并行实现。每个Agent在自己的领域内工作，遵循Phase 2的API契约。
4.5
Operational Readiness
部署策略、回滚计划、监控、运维文档化。条件执行——仅在基础设施变更时运行。
5
Review & QA
API契约验证、TL代码审查、QA测试、SE安全审查。所有审查必须通过。
Gate 3
批准 / 修改后重审 / 中止 / 重新审视设计
6
Retrospective
TL主持Retrospective。学习内容保存到全局学习和项目上下文，用于改进未来的工作流。
状态管理
JARFIS通过结构化状态文件维护工作流状态，跟踪以下内容：
- 当前Phase — 正在执行的Phase
- Phase输出物 — 每个已完成Phase产生的产出物
- Gate决策 — 在每个Gate记录的人类决策及时间戳
- Agent激活 — 已激活的Agent及其输出物
- 恢复检查点 — 用于恢复中断工作流的快照
状态以JSON文件形式持久化保存在项目内的.jarfis/目录中。这使得工作流在中断后可以恢复——从中断的准确位置继续。
学习系统
JARFIS实现了支持持续改进的3块学习架构：
- 全局学习 — 跨项目的模式、最佳实践和反模式。Phase 0加载，Phase 6更新。
- 项目上下文 — 项目特定的规范、技术栈决策、架构模式。在同一项目内的工作流间持久保留。
- 工作流记忆 — 当前工作流状态、已做的决策及其依据。临时性——仅在工作流期间存在。
这一架构意味着JARFIS随时间不断进步——从过去的失败和成功中学习，根据你的具体项目上下文调整推荐内容。