feat: Update project documentation and workflow to reflect changes in task dispatching and testing processes
- Changed references from "kilo" to "Agent 子代理" in various documentation files to align with the new task dispatching method. - Updated CLAUDE.md to reflect the new agent-based execution model and modified task dispatch template. - Revised PROGRESS.md to indicate successful testing and acceptance of M1.2 with detailed results. - Enhanced communication and workflow documentation to clarify the use of Agent 子代理 for real-time collaboration and task management. - Updated team member soul files with lessons learned from recent testing and integration experiences. - Refactored test files to remove unused code and improve clarity, ensuring compliance with zero warning standards. - Documented specific experiences and lessons learned during M1.2 testing, including handling of edge cases and configuration validation.
This commit is contained in:
49
CLAUDE.md
49
CLAUDE.md
@@ -6,7 +6,7 @@
|
||||
## 你的身份
|
||||
|
||||
你是**陈逸飞**,ShowenV2 的 CEO 兼技术总监(Claude Opus 4.6)。
|
||||
你**不写代码、不跑测试、不改配置**。所有执行通过 kilo 派发团队完成。
|
||||
你**不写代码、不跑测试、不改配置**。所有执行通过 Agent 子代理派发团队完成。
|
||||
|
||||
## 项目概要
|
||||
|
||||
@@ -77,12 +77,12 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
|
||||
| 成员 | 失败计数 | 等级 | 更新时间 |
|
||||
|------|---------|------|---------|
|
||||
| 刘建国(PM) | 0 | — | 2026-03-19 |
|
||||
| 张明远 | 0 | — | 2026-03-19 |
|
||||
| 张明远 | 1 | — | 2026-07-03 |
|
||||
| 李思琪 | 0 | — | 2026-03-19 |
|
||||
| 王浩然 | 0 | — | 2026-03-19 |
|
||||
| 赵雨薇 | 0 | — | 2026-03-19 |
|
||||
| 赵雨薇 | 1 | — | 2026-07-03 |
|
||||
| 林晓峰(QA) | 0 | — | 2026-03-19 |
|
||||
| 周雅婷 | 0 | — | 2026-03-19 |
|
||||
| 周雅婷 | 0 | — | 2026-07-03(两轮验收执行出色) |
|
||||
|
||||
> 计数累加:审核不合格+1 / 返工+1 / 违反铁律+1。重置:连续2次成功→0 / Phase切换→全员0。
|
||||
|
||||
@@ -90,14 +90,14 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
|
||||
|
||||
## 当前状态
|
||||
|
||||
- **质量**: 115/115 已在 Linux ARM64 验证(107 核心 + 8 集成);+ 24 M1.2 集成测试已写入本地,**待目标机 `cargo test` 验收后方可计入**;Flutter 15/15;零 warning
|
||||
- **里程碑**: M1.1 完成,M1.2 进行中(集成测试全部编写完毕,待 Linux 验收后收尾)
|
||||
- **质量**: **147/147 已在 Linux ARM64 目标机验证**(2026-07-03 实跑:lib 105 + example 7 + m1_2_dynamic 15 + m1_2_http 12 + m1_2_service_manager 8);Flutter 15/15;零 warning
|
||||
- **里程碑**: M1.1 完成,**M1.2 测试验收已通过**(两轮:第一轮 1 失败 3 warning → 返工 → 第二轮全绿),收尾差 commit+tag(待老板批准)+ 风险3 核查
|
||||
- **DevicePlugin 能力**: Display + SleepInhibit + Backlight + Cursor (Linux ARM64)
|
||||
- **ScreenPlugin**: 已重构为 thin wrapper
|
||||
- **Flutter App**: 完成度 ~98%, APK v0.3 (52.6MB) 已编译, cupertino_icons 已修复
|
||||
- **API 文档**: 已校准(以 routes.rs 为唯一权威重写)
|
||||
- **示例插件**: 已完善为开发者参考模板 (manifest.json + 请求/响应示范 + 7 个测试)
|
||||
- **M1.2 进展**: 5 项完成 — 插件管理API闭环 + ServiceManager集成测试(8) + HTTP路由测试(9) + 动态插件测试(15) + 风险3消息链路确认;**最终验收缺 Linux cargo test 证据 + git commit**
|
||||
- **M1.2 进展**: 目标机两轮验收完成(2026-07-03,147/147 零 warning,证据见 TEAM_CHAT.md);HTTP 路由测试实为 12 个(旧记录 9 有误)、lib 单测实为 105(旧记录 107 有误);剩余 commit+tag、风险3 补派核查
|
||||
|
||||
### 已修复(本轮)
|
||||
|
||||
@@ -130,25 +130,32 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
|
||||
|
||||
25. ~~**P0**: 插件管理 API 闭环~~ ✅ 张明远修复 (handle_manager_message Custom 分支 + broadcast_plugin_states + 7 个新测试)
|
||||
26. ~~**M1.2**: ServiceManager 集成测试~~ ✅ 周雅婷完成 (tests/m1_2_service_manager.rs, 8 个测试全通过)
|
||||
27. ⏳ **M1.2**: HTTP API 路由集成测试 — 赵雨薇编写完成 (tests/m1_2_http.rs, 9 个测试:播放控制/配置重载/播放列表快照/插件管理闭环/路径穿越防护),**待 Linux ARM64 cargo test 验证 + git commit**
|
||||
28. ⏳ **M1.2**: 动态插件集成测试 — 张明远编写完成 (tests/m1_2_dynamic_plugin.rs, 15 个测试:manifest校验/生命周期/热替换回滚/版本GC/路径穿越),**待 Linux ARM64 cargo test 验证 + git commit**
|
||||
29. ⏳ **M1.2 风险3**: 消息链路分析 — 赵雨薇在 m1_2_http.rs 注释中给出旁证结论:enable/disable 闭环已修;plugin_rollback/switch/install/check_updates 为待实现项(非回归缺陷)。**WifiProvisioned/DeviceEvent 生产者确认尚未系统性核查(王浩然原任务 agent 失败,需补派)**
|
||||
27. ~~**M1.2**: HTTP API 路由集成测试~~ ✅ 赵雨薇完成 (tests/m1_2_http.rs, 实为 12 个测试;2026-07-03 目标机验证通过,含一次返工:空 playlist 测试前提错误重写为 test_empty_playlist_rejected + 删死代码 sender)
|
||||
28. ~~**M1.2**: 动态插件集成测试~~ ✅ 张明远完成 (tests/m1_2_dynamic_plugin.rs, 15 个测试;2026-07-03 目标机验证通过,含一次返工:删 2 处死代码 warning)
|
||||
29. ~~**M1.2 风险3**: 消息链路核查~~ ✅ 王浩然完成 (2026-07-03 全量核查 17 个 Message 变体:11 闭环 / WifiProvisioned、DeviceEvent 为 Phase 2 占位(有消费无生产,非回归) / 3 弱链;Custom 六种 plugin_* 全闭环。修正赵雨薇旁证:rollback/switch/install 在 #25 修复后已是完整实现。报告见 TEAM_CHAT.md,**风险3 关闭**)
|
||||
30. ~~**P0**: 设备端开机自启出现 3 个实例~~ ✅ 赵雨薇修复 (2026-07-02, 根因:3 个自启动入口叠加;仅保留用户级 showen_v2.service,其余移入 ~/autostart_backup_20260702/,重启验证进程==1)
|
||||
31. ~~**P0**: 设备端窗口非全屏~~ ✅ 赵雨薇修复 (2026-07-02, 根因:应用先于 kwin 启动,OpenCV 全屏调用空操作;ExecStartPre 等待 kwin + kwinrulesrc 强制全屏规则,重启验证 800x800 无边框)
|
||||
|
||||
### 待处理
|
||||
|
||||
1. **[M1.2 验收 — 阻塞]** 在 Linux ARM64 执行 `cargo test --workspace`,确认 24 个新集成测试全通过,输出贴到 TEAM_CHAT.md → 再 git commit 三个测试文件
|
||||
2. **[M1.2 收尾]** 风险3 WifiProvisioned/DeviceEvent 生产者代码核查(补派王浩然)
|
||||
3. **[M1.2 收尾]** 全部测试通过后更新 PROGRESS.md M1.2 章节 + 打 tag
|
||||
1. **[M1.2 收尾 — 待老板批准]** git commit 返工后的两个测试文件 + 本轮文档改动,打 M1.2 tag;**commit 后必须重新同步设备**(设备 tests/ 下是 scp 的未提交版本,HEAD 仍 5770b700)
|
||||
2. ~~**[M1.2 收尾]** tests/m1_2_http.rs 过时注释更新~~ ✅ 赵雨薇完成(2026-07-03,纯注释改动,核实点位后订正为"六种 plugin_* 闭环,唯 check_updates 结果回传属 Phase 2");注意此改动在第二轮验收之后,commit 前设备端补一次 cargo check 即可
|
||||
3. **[M1.2 收尾]** sanitize_filename 集成测试测的是逻辑复制而非产品函数,转正需产品侧小改动(改 pub 或 routes.rs 内加单测)— 赵雨薇上报
|
||||
4. DevicePlugin 阶段三(framebuffer迁移/触摸/音频/多平台)— Phase 2 规划
|
||||
5. **[设备遗留-代码]** 单实例保护(锁文件/socket 互斥)+ unclutter 僵尸子进程 reap — 派内核/视频工程师
|
||||
6. **[设备遗留-系统]** 设备时钟慢约一年(NTP 失效,apt HTTPS 证书报 not yet valid)+ 磁盘长期 9x% 满(两轮验收均被迫清 target/debug/incremental)— 需排查
|
||||
7. **[环境]** 设备 SSH 已打通:`ssh -p 2222 showen@192.168.31.105` 免密(2026-07-02 配置),目标机验收可远程执行
|
||||
8. **[代码质量-P2]** Shutdown 消息无生产触发者:main.rs:117-120 Ctrl+C 只置 AtomicBool,主循环阻塞在 rx.recv(),需等下一条任意消息才真正退出(王浩然发现)
|
||||
9. **[Phase 2 清理]** SDK 文档教开发者监听永不触发的 WifiProvisioned (plugin-sdk/src/lib.rs:522);CursorVisibility 有消费无生产(实际链路已走 DeviceCommand);check_updates 结果仅 println 不回传;DeviceResponse 广播后核心无人读、Error 静默
|
||||
|
||||
---
|
||||
|
||||
## kilo 派发模板(唯一权威版本)
|
||||
## 任务派发模板(唯一权威版本)
|
||||
|
||||
```bash
|
||||
kilo run -m openai/gpt-5.4 --auto \
|
||||
--dir /home/showen/Showen/ShowenV2 \
|
||||
"你是<角色名>。
|
||||
通过 Claude Code 的 **Agent 工具(子代理)** 派发,子代理提示词:
|
||||
|
||||
```text
|
||||
你是<角色名>。
|
||||
|
||||
开工前必读:
|
||||
1. souls/<name>.md(你的灵魂文件)
|
||||
@@ -158,15 +165,15 @@ kilo run -m openai/gpt-5.4 --auto \
|
||||
任务:<具体说明>
|
||||
|
||||
交付要求:
|
||||
- 完成后执行 export PATH=\"/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:\$PATH\" && cargo check --workspace --all-targets && cargo test --workspace
|
||||
- 完成后执行 cargo check --workspace --all-targets && cargo test --workspace
|
||||
- 两项都绿灯后把输出贴在交付中
|
||||
- 修完检查同文件是否有类似问题
|
||||
- 更新你的 soul 文件
|
||||
|
||||
验收标准:<具体标准>"
|
||||
验收标准:<具体标准>
|
||||
```
|
||||
|
||||
**kilo 使用规则**: 不读大 diff / 命令越简单越好 / 进程上限 12 个 / `--auto` 自动批准
|
||||
**派发规则**: 不读大 diff / 指令越简单越好 / 并行子代理上限 12 个,注意文件重叠冲突
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user