Lanqiao-Luca·Lanqiao-Luca/ai-java-workflow/AGENTS.md

ai-java-workflow

AGENTS.md220 starsChanged 8 days agoMITView on GitHub

目的：约定本仓库协作的范围、角色入口、单源方法、原件保护与真实交付边界。 适用于：在本仓库工作且已有当前任务授权的助手与维护者；不扩大外部动作权限。 先核目标、实际目录、基线和允许写集；保护已有改动。按任务从 Agents 选职责，经 Skills 取得 Standards 方法，简单任务不要求所有角色参与。文档是方法与职责，不等于平台注册或已启动进程。 处理新请求或续作时，先按 Brain 核本轮变化，经 职责路由 从 Graph、Loop、Workflow、Agent 中选择适用入口；高层组织下层并交到阶段 Agent，具体 Skill、Standards、Tools 由 Agent 经 Skill 使用，Brain 不直接执行这些底层能力。同任务复用有效状态，只刷新变化部分；Brain 是文档入口，不代表自动派工或新增授权。 规范保持单源。Standards 与 Tools 平级，分别提供规则方法与执行工具；Skill 组合适配两者，Agent 对选择、结果和交接负责。Workflow、Loop、Graph 各保留 templates 与 examples，执行前由责任 Agent 实例化计划，续作保留原状态；规范和工具不反向启动角色。来源证据、导航与运行依赖分别说明，不能用空壳链接冒充真实消费。 新增例子使用独立虚构数据。凭证、个人身份、内部服务坐标、公司业务规则、运行记录和来源不清内容不得进入本目录。文件可读不等于可以公开；不把打码或改名当充分抽象。 新建或维护文档先交文档维护者 Agent，经文档维护 Skill 核每份文件的目的、适用对象及实际差异；原子规则保单源。历史原件不为新格式改写，其用途和适用范围放在档案旁证。声明结构检查不替代语义审验。 变更同步更新 public-manifest.json，执行 README 的本地检查并审阅正文。记录当前候选、实际验证、失败、跳过与未知。只有真实分离上下文才称独立审查，原则审查不能替代业务与运行验收。 提交、推送、发布、部署和外部传输按当前明确授权处理；方法示例不授予这些权限。原始资料保持只读，私有审计存放于本项目之外。