跳转至正文

指南与自定义

JARFIS高级模式:Meeting-to-Work联动、角色配置、项目档案、Gate交互、学习系统管理与工作流恢复。

最后更新: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

掌握JARFIS高级模式——从会议与工作项的联动,到自定义Agent角色、管理Gate、从中断中恢复。

Meeting-to-Work联动

JARFIS将会议成果直接连接到开发工作流。先运行会议生成结构化输出,再将输出连接到work命令,让整个流水线从完整上下文起步。

/jarfis:meetingsummary.md + decisions.md + meeting-notes.md/jarfis:work --meetingPhase 0加载会议上下文

分步操作

  1. 带主题运行会议命令:
/jarfis:meeting Define the authentication strategy for the mobile app

执行结果生成summary.mddecisions.mdmeeting-notes.md

  1. 使用--meeting标志将会议输出连接到work命令:
/jarfis:work Implement mobile auth with biometric login --meeting auth-strategy-meeting
  1. Phase 0(Pre-flight)自动加载会议上下文。后续所有Phase的Agent都能参考会议中做出的决策。

提示: --meeting标志引用会议输出目录。Phase 0加载所有会议产出物,流水线中的每个Agent都能访问讨论过的决策和约束。

角色配置

JARFIS使用.jarfis-state.json中的required_roles字段来确定工作流中哪些Agent角色处于激活状态。这控制了哪些Phase会执行,以及Phase 4中并行工作如何分配。

{
  "required_roles": {
    "backend": true,
    "frontend": true,
    "ux": false,
    "devops": false,
    "security": true
  }
}
Frontend Only
Phase 3(UX)激活,Phase 4仅运行FE实现
backend:false
frontend:true
ux:true
devops:false
security:false
Full Stack + Security
所有Phase激活,Phase 4运行BE/FE/DevOps并行
backend:true
frontend:true
ux:true
devops:true
security:true
Backend API Only
跳过Phase 3(UX),Phase 4仅运行BE + DevOps
backend:true
frontend:false
ux:false
devops:true
security:true

注意: JARFIS在Phase T(Triage)期间根据工作描述和项目结构自动确定角色。可以在批准Gate 1之前通过编辑.jarfis-state.json来覆盖。

继续已完成的工作流

使用/jarfis:continue在已完成的工作流基础上继续工作——添加测试、修复边界情况或扩展范围,无需从头开始。

/jarfis:continue Add unit tests for the auth module
/jarfis:continue Fix the token refresh edge case --mode fix
Fix Mode
跳过Triage和Discovery,直接进入Implementation Phase进行精准修复。
--mode fix
Extend Mode
跳过Triage但运行Discovery,以便正确确定新增内容的范围。
--mode extend

也可以使用--workflow path指定要继续的特定过往工作流的输出。

项目档案

项目档案让JARFIS全面了解您的代码库——仓库结构、依赖关系、构建工具和规范——确保每个工作流都从准确的项目上下文开始。

  1. 1
    /jarfis:project-init — 分析仓库结构、依赖关系、构建工具和规范,生成.jarfis/project-profile.md
  2. 2
    /jarfis:project-update — 当项目发展时,在保留手动添加上下文的同时刷新档案。

提示: 在仓库中首次设置JARFIS时运行一次/jarfis:project-init,主要依赖项或结构变更后使用/jarfis:project-update

使用Gate

Gate是人类监督的主要机制。每个Gate提供控制工作流方向的具体操作。

Gate 1 — Phase 1(Discovery)之后
审查PRD、可行性分析和范围定义。这是调整方向成本最低的节点。
批准修改中止
Gate 2 — Phase 2 & 3(Architecture + UX)之后
审查架构决策、任务分解和UX设计。仔细检查tasks.md——遗漏的任务意味着遗漏的功能。
批准修改中止
Gate 3 — Phase 5(Review & QA)之后
审查所有实现、测试结果和安全发现。"重新审视设计"针对根本性架构问题,将工作退回Phase 2。
批准修改后重审中止重新审视设计

重要: Gate 1花的几分钟能节省Gate 3的几小时。早期纠偏比晚期纠偏代价小得多。在每个Gate都要认真审查。

管理学习系统

JARFIS运行着一套两级学习系统,通过积累的项目知识持续提升输出质量。

Global
全局学习
存储于~/.claude/jarfis-learnings.md。包含跨所有项目共享的Agent Hints和Workflow Patterns。
Project
项目上下文
存储于.jarfis/context.md。该项目特有的技术栈、规范、业务领域和集成约束。

学习循环

Phase 6 (Retro)learnings.mdPhase 0 (Pre-flight)Agent参考更好的输出

context.md示例

# Project Context
## Tech Stack
- Frontend: Next.js 15, TypeScript strict, Tailwind CSS 4
- Backend: FastAPI (Python 3.12), PostgreSQL 16, Redis
## Conventions
- API responses follow RFC 9457 Problem Details format
- All database models use UUID primary keys
- Commit format: conventional commits

使用/jarfis:upgrade整理学习条目——保留、编辑或删除,维持质量。

上下文压缩后的工作流恢复

JARFIS通过.jarfis-state.json将Phase和进度状态持久化到磁盘。无需特殊恢复命令——系统自动检测并恢复中断的工作流。

  1. 1
    会话终止 — 连接断开、超时或上下文压缩
  2. 2
    再次运行/jarfis:work — 使用与之前相同的工作描述
  3. 3
    JARFIS检测到现有状态文件 — 找到包含进行中工作流的.jarfis-state.json
  4. 4
    从最后的检查点恢复 — 从上一个会话中断的准确位置继续工作

关键: 没有特殊的恢复命令。只需用相同描述运行/jarfis:work,JARFIS就会通过持久化的状态文件自动处理恢复。

修改JARFIS本身

当您想要修改或扩展JARFIS本身——添加新命令、更改Agent行为或更新流水线结构——使用/jarfis:implement

/jarfis:implement Add a /jarfis:standup command for daily status reports

工作原理: /jarfis:implement理解JARFIS系统结构,将变更应用到所有受影响的文件——提示模板、命令定义、Phase处理器和文档。

实践示例

常见开发场景的实际使用模式:

示例 1 — 纯前端工作
/jarfis:work Redesign the dashboard with new chart components
Triage激活frontend + UX角色。Phase 3(UX Design)运行,Phase 4仅执行FE实现。
示例 2 — 结合会议的全栈工作
/jarfis:meeting Plan the multi-tenant architecture migration
/jarfis:work Implement multi-tenant data isolation --meeting tenant-architecture
会议产出决策和约束。work命令连接会议输出,以完整上下文执行流水线。
示例 3 — 快速修复
/jarfis:work Fix the broken pagination on the orders list
Triage将其归类为小型修复。以最简流程运行精简流水线。
示例 4 — 继续已完成的工作
/jarfis:continue Add internationalization support to the auth module
继续之前完成的工作流。保留现有上下文,通过新的Discovery阶段扩展范围。
示例 5 — 健康检查
/jarfis:health
诊断僵尸进程、过期状态文件及其他工作流健康问题。

下一步