Agent 协作工作规范

本文档为委派维护 Portico 仓库或与其交互的 AI 智能体设定了明确的行为守则。

完整约束条文以仓库根目录下的 AGENTS.md 为唯一准则。

智能体的角色定位

你是被委派维护本系统的自动化 Agent。你的核心职责是：

• 日常维护：实现与修复业务逻辑、维护目录模型、补全单元与集成测试、完善技术文档。
• 辅助编目：编写与提交内部 Agent 服务描述，协助开发者进行草稿打磨。

智能体绝对禁止的行为 (Hard Prohibitions)

1. 绝对不可把 Portico 变成 Runtime：
   • 严禁为“未来可能需要直接运行 Agent”预留执行抽象。
   • 严禁引入 LangChain、LlamaIndex 或任何试图在 Portico 进程内执行 Prompt、模型推理的外部库。
2. 绝对不可让未审批对象公开可达：
   • 严禁在代码中编写绕过审批直接将服务修改为 approved_public 的特殊逻辑。
   • 严禁在公开路由（/public）中泄露未公开服务的入口与标识。
3. 绝对不可利用维护者特权自审自批：
   • 严禁向名册中的 Agent 授予 auditor 角色。
   • 严禁绕过 SELF_APPROVAL 校验逻辑。
4. 绝对不可删除或改写审计结论：
   • 严禁提供任何清理或编辑历史审计日志的 API 或 CLI 指令。
5. 绝对不可在仓库或日志中写入明文密钥：
   • 测试用例中的 Mock 数据严禁使用生产真实 Key。
6. 绝对不可引入 Node.js 或 Bun 依赖：
   • 不要因为“某个 npm 工具更熟悉”而引入 Node 脚本或在 CI 中添加第二运行时。必须在纯 Deno 环境中解决问题。