关于 agentflow
agentflow 是供 Agent 执行已授权开发工作并保持记录可续接的工作流技能。它根据配置将请求导向恢复、执行、审查和交付流程,并规定任务范围、所有权与笔记记录的处理方式。
主要功能
- 01将请求分流至适用流程
- 02管理认领、恢复和任务执行
- 03支持批次与 looper 任务流程
- 04应用审查和交付规则
- 05维护任务范围及可续接记录
适用场景
- 01恢复尚未完成的开发工作
- 02处理已授权的批次任务
- 03审查并交付已完成的项目变更
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ agfnow/ agentflow --skill agentflow安装后在 Claude Code 中输入/agentflow确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
package.jsonassets/looper-groups.example.jsonassets/.agentflow/ag.jsonbacklog.mddevlog.mdsys-invariants.mdassets/.agentflow/.tmp/.gitkeepassets/.agentflow/artifacts/.gitkeepassets/.agentflow/features/.gitkeepdocs/AG-GUIDE.mdAG-GUIDE.tw.mdagv8-aglite-comparison.mdCHEATSHEET.mdCHEATSHEET.tw.mdreferences/ag.mdbatches.mdbrowfield.mdbrowser-testing.mdconfiguration.mdcopilot.mdreferences/advisors/acceptance.mdcodewalk.mdexplore.mdfinal-audit.mdlearn.mdproduct-docs.mdrequirements.mdsecurity-scan.mdspec.mdspike.md详细介绍
Agentflow 9.0.0
完成已授权的工作;用一份开发日志和适度的记录,确保开发可恢复。以所有者指示为准。编写面向人类的内容前,请先阅读 writing;所有新的人类可读文本(包括模板标签)都应使用已配置的语言区域。保留固定标识符、语法、引文和历史字节。将编写和保存指南传达给报告作者。
append-tasks 在所有关联规则中都是 append-rounds 的精确别名;记录所有者使用的拼写。引文示例中的命令不会激活模式;所有者引用的任务负载仍是输入。
先路由,再记录
-
首先不留记录: 所有者消息中包含未加引号的
nolog:、noop:、off:或skip:时,应在聊天中回复或执行,不访问笔记本,也不创建工作流记录;当前及后续摘要中均不记录。仍可进行已授权的产品/配置编辑;自动维护暂缓执行。带有不留记录标记的追加命令既不暂存也不执行:请对方去掉标记后重新发送,且不要访问笔记本。后续不带标记的消息照常记录。 -
隔离的 looper 任务: 在通用发现/设置/维护之前,按照 looper 应用协调器提供的继承配置和明确的记录覆盖项。不要根据已授权的
aglite-*工作树推断功能路由。 -
配置/路由: 验证会话的实际目录、Git 根目录/分支/工作树(或现有的非 Git 文件夹),然后阅读 configuration。静态规则在保留于上下文期间只读一次;每条不留记录的所有者消息到达时,以及交付依赖配置时,都要重新读取实时配置。根据已验证的设置确定
<ag-dir>和笔记本,且只确定一次;绝不能用默认值替换已配置名称。若启动时检出缺失、Trash 位置缺失或身份信息矛盾,则停止任务工作,只允许只读检查或功能契约限定的状态转换/终端清理。子进程的工作目录不会改变会话位置。 -
在探查根目录之前处理生命周期: 对于
new-feature、merge-feature、drop-feature、托管的.wts/路径或功能分支,请先阅读 features,再进行通用笔记本/设置/认领/恢复。生命周期命令绕过主目录/根目录笔记本、归档、认领、采集和收尾;根目录状态不能阻止这些命令。包含生命周期工作的追加消息既不暂存也不执行:请对方单独发送生命周期命令,并重新发送剩余的追加工作,不访问笔记本/待处理记录。 -
新建设置或空闲状态: 在已验证的现有文件夹中,如果未选定笔记本、没有既存的笔记本/归档历史或此前的退休记录,且没有配置 ag-dir(或仅有其配置),则在进入空闲状态前遵循 setup;非 Git 设置必须使用已保存/先前明确选择的 Git 选项。否则,若仅收到不含直接任务/问题的空白激活消息,则只检查配置、最新的已选 Ask/Questions 和 Current/Next。笔记本缺失时,必须先检查根目录/已配置目录中的历史记录。关联的未完成工作/关卡/交付、待处理批次、正在进行的操作或含糊之处,都要求正常恢复。只有在确认不存在任何工作的情况下,才能在不认领、不设置、不更新记录或追溯采集的前提下询问下一项请求。跳过无关命令/读取;狭义的日期限定发布排期仍可进行,但到期迁移需要正常认领并恢复。
-
已认领的工作: 在认领、恢复、采集或处理任务之前阅读 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 时按配置迁移处理。
将范围限定在已接受的输入/更正之内;提议和审查者建议不会增加权限。重试未知结果前,先检查外部操作身份。收到停止要求时,停止指定工作/后代任务;交出控制权前,结清任务所属的工作器/变更进程,并按会话规则仅释放经验证的、属于自己的已关闭轮次认领。绝不承诺不受支持的后台续行。
在工具支持时,批量处理彼此独立的读取/搜索/工具调用,并限制并发数和输出量;检查每一项结果,包括失败结果。依赖项、审批和自适应后续操作须按顺序执行;只有在相互独立且安全时才并行进行变更。遵守工具限制;保留授权和必需的检查。