ppanel/AGENTS.md

2.1 KiB
Raw Permalink Blame History

PPanel 协作规则

目标与事实来源

  • 阅读 docs/specs/2026-09-12-mvp-plan-and-acceptance.md、docs/specs/2026-09-12-connectivity-verification.md 和 docs/implementation-contract.md。
  • 项目是本地 Web 控制面;内部编排 agent 用 pi-agent SDK 编写,外部执行 agent 使用 pi CLI、OpenCode 和 Codex App Server。
  • 每位执行者在独立 clone 和会话中工作。任务和交付以 Gitea Issue/PR/提交为准,不读取其他执行者目录或日志,不私信交接。
  • Issue、PR、评论和提交说明默认中文 Markdown;机器元数据与正文分开。不要把 JSON 当成用户正文。

实现边界

  • 必须使用 @earendil-works/pi-agent-core / @earendil-works/pi-ai 0.85.0;参考 /Users/pptg/workspace/project/d-sre-agent 的实现和 /Users/pptg/.d-sre-agent/config/sre-agent.yaml 的本机配置,禁止将密钥提交或打印。
  • 前端严格复用 D-SRE 的 UI、主题和共享布局。缺口优先使用 shadcn;保留原许可声明,新增样式需说明为何现有类无法覆盖。
  • 开发 agent 不得自行宣布最终验收通过;独立 CR 和 QA 的证据必须对应同一当前 SHA 与需求版本。
  • 不修改、删除或弱化冻结验收要求来获取通过。Mock 可以用于明确的故障注入,不能冒充真实模型、Git 或产品联调成功。
  • 不引入不需要的架构层。优先 Node 标准库、已有库和小型清晰模块。使用 meaningful tests 验证状态、并发、协议与版本门禁。
  • 执行本 Issue 内已授权的实现,不需要再等待设计批准或创建 Codex 桌面任务。具体实现工作使用当前外部 agent;不擅自通过别的通信渠道委派。

交付

  • 只修改 Issue 分配的文件范围;先提交、push,再用中文 Markdown 回报分支、SHA、测试与限制。
  • 完整保留日志与证据,禁止把“进程退出 0”“模型称完成”当作真实交付。
  • 模型/服务器配置只从本机环境或配置路径加载,凭据使用 Git credential helper;运行目录、依赖、构建文件不得提交。