2.1 KiB
2.1 KiB
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-ai0.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;运行目录、依赖、构建文件不得提交。