mcpField
A
agentflow

agentflow

github.com/agfnowAgent 工作流6785 次安装2 天前更新
代码仓库

关于 agentflow

agentflow 是供 Agent 执行已授权开发工作并保持记录可续接的工作流技能。它根据配置将请求导向恢复、执行、审查和交付流程,并规定任务范围、所有权与笔记记录的处理方式。

主要功能

  1. 01将请求分流至适用流程
  2. 02管理认领、恢复和任务执行
  3. 03支持批次与 looper 任务流程
  4. 04应用审查和交付规则
  5. 05维护任务范围及可续接记录

适用场景

  1. 01恢复尚未完成的开发工作
  2. 02处理已授权的批次任务
  3. 03审查并交付已完成的项目变更

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/agfnow/agentflow --skill agentflow

安装后在 Claude Code 中输入/agentflow确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

package.json
assets/
looper-groups.example.json
assets/.agentflow/
ag.json
backlog.md
devlog.md
sys-invariants.md
assets/.agentflow/.tmp/
.gitkeep
assets/.agentflow/artifacts/
.gitkeep
assets/.agentflow/features/
.gitkeep
docs/
AG-GUIDE.md
AG-GUIDE.tw.md
agv8-aglite-comparison.md
CHEATSHEET.md
CHEATSHEET.tw.md
references/
ag.md
batches.md
browfield.md
browser-testing.md
configuration.md
copilot.md
references/advisors/
acceptance.md
codewalk.md
explore.md
final-audit.md
learn.md
product-docs.md
requirements.md
security-scan.md
spec.md
spike.md

详细介绍

Agentflow 9.0.0

完成已授权的工作;用一份开发日志和适度的记录,确保开发可恢复。以所有者指示为准。编写面向人类的内容前,请先阅读 writing;所有新的人类可读文本(包括模板标签)都应使用已配置的语言区域。保留固定标识符、语法、引文和历史字节。将编写和保存指南传达给报告作者。

append-tasks 在所有关联规则中都是 append-rounds 的精确别名;记录所有者使用的拼写。引文示例中的命令不会激活模式;所有者引用的任务负载仍是输入。

先路由,再记录

  1. 首先不留记录: 所有者消息中包含未加引号的 nolog:、noop:、off: 或 skip: 时,应在聊天中回复或执行,不访问笔记本,也不创建工作流记录;当前及后续摘要中均不记录。仍可进行已授权的产品/配置编辑;自动维护暂缓执行。带有不留记录标记的追加命令既不暂存也不执行:请对方去掉标记后重新发送,且不要访问笔记本。后续不带标记的消息照常记录。

  2. 隔离的 looper 任务: 在通用发现/设置/维护之前,按照 looper 应用协调器提供的继承配置和明确的记录覆盖项。不要根据已授权的 aglite-* 工作树推断功能路由。

  3. 配置/路由: 验证会话的实际目录、Git 根目录/分支/工作树(或现有的非 Git 文件夹),然后阅读 configuration。静态规则在保留于上下文期间只读一次;每条不留记录的所有者消息到达时,以及交付依赖配置时,都要重新读取实时配置。根据已验证的设置确定 <ag-dir> 和笔记本,且只确定一次;绝不能用默认值替换已配置名称。若启动时检出缺失、Trash 位置缺失或身份信息矛盾,则停止任务工作,只允许只读检查或功能契约限定的状态转换/终端清理。子进程的工作目录不会改变会话位置。

  4. 在探查根目录之前处理生命周期: 对于 new-feature、merge-feature、drop-feature、托管的 .wts/ 路径或功能分支,请先阅读 features,再进行通用笔记本/设置/认领/恢复。生命周期命令绕过主目录/根目录笔记本、归档、认领、采集和收尾;根目录状态不能阻止这些命令。包含生命周期工作的追加消息既不暂存也不执行:请对方单独发送生命周期命令,并重新发送剩余的追加工作,不访问笔记本/待处理记录。

  5. 新建设置或空闲状态: 在已验证的现有文件夹中,如果未选定笔记本、没有既存的笔记本/归档历史或此前的退休记录,且没有配置 ag-dir(或仅有其配置),则在进入空闲状态前遵循 setup;非 Git 设置必须使用已保存/先前明确选择的 Git 选项。否则,若仅收到不含直接任务/问题的空白激活消息,则只检查配置、最新的已选 Ask/Questions 和 Current/Next。笔记本缺失时,必须先检查根目录/已配置目录中的历史记录。关联的未完成工作/关卡/交付、待处理批次、正在进行的操作或含糊之处,都要求正常恢复。只有在确认不存在任何工作的情况下,才能在不认领、不设置、不更新记录或追溯采集的前提下询问下一项请求。跳过无关命令/读取;狭义的日期限定发布排期仍可进行,但到期迁移需要正常认领并恢复。

  6. 已认领的工作: 在认领、恢复、采集或处理任务之前阅读 session;先认领,再完整恢复/执行。保留无关编辑。处理受影响的工作前,遵循共享/本地项目规则和 invariants;权威规则不可用时,依赖这些规则的写入/验收应暂缓。空白的 godev 会恢复未完成的工作;激活不会凭空创建项目任务。

仅加载适用的流程

  • 批次:追加命令、针对待处理批次的更正,或恢复待处理轮次。宿主负责队列、认领、捕获、集成和交付;对于已到达的批次,除非宿主例外规定,否则优先使用有界原生实现工作器。

  • 工作:实际项目执行、任务模式(browfield、fast-lane、grill-me、skip-review、顾问/3ways)或请求的差异内容。规划:适用的设计/跟踪标准、请求的或有实质性修订的契约或关卡;普通问答不加载执行或设计契约。仅规划不授予实现权限。

  • 审查:规划路由、结果审查或派发工作器之前。除非适用有效的任务豁免,否则配置的独立结果审查适用于已更改的代码、操作提示词、产品产物和可供实施的契约。宿主负责审查普通问答。仅在 Copilot 宿主或选择了 Copilot 路由/配置文件时,才阅读 Copilot。每次 Codex spawn_agent 都必须显式使用 fork_turns: "none",并提供完整且有界的上下文。

  • 交付:呈现 STATUS/回复、收尾、归档、Git 交付或显式重命名笔记本之前。若 inline-reply: off,须将所有实质性答复/提议/示例/问题保存到其现有记录位置;聊天中只包含活动、必需的通知/阻塞事项/交接,以及准确的本地化回执。只有明确要求以聊天/终端为目标位置时,才可在那里提供所请求的答复。不要通过工具重复已保存的答复。

  • 设置:符合条件的初始创建,或在实际工作中采用 AGENTS。维护:配置迁移/移动,或经批准的安装替换;检测到 Agentflow8/集成触发时,首先加载旧版迁移;两者都不会授予发布权限或无关编辑权限。

  • 循环器:执行 prepare-tasks、run-tasks、handle-tasks、执行任务或恢复之前。准备阶段保存与 Current 关联的队列/计划文件后停止;运行阶段执行队列;处理阶段兼顾两者。只有此功能允许使用其限定范围内的 Node 协调器/agf 启动器。保留常规任务设置、隔离、原生实时宿主/邮箱要求及仅限所有者的边界;不得因此使用 CLI 替代方案,也不会获得清理/推送/发布权限。

  • Windows:Windows 或明确的可移植性工作。专业顾问、棕地、浏览器和产品文档参考在 work/review 中规定的触发条件下加载;不要例行加载所有参考资料。若 saving-mode: on,撰写内容前先阅读 保存模式;关闭时保留正常行为;缺少 saving-mode 时按配置迁移处理。

将范围限定在已接受的输入/更正之内;提议和审查者建议不会增加权限。重试未知结果前,先检查外部操作身份。收到停止要求时,停止指定工作/后代任务;交出控制权前,结清任务所属的工作器/变更进程,并按会话规则仅释放经验证的、属于自己的已关闭轮次认领。绝不承诺不受支持的后台续行。

在工具支持时,批量处理彼此独立的读取/搜索/工具调用,并限制并发数和输出量;检查每一项结果,包括失败结果。依赖项、审批和自适应后续操作须按顺序执行;只有在相互独立且安全时才并行进行变更。遵守工具限制;保留授权和必需的检查。

评论

支持 Markdown