project-doctor
项目体检技能。在需要审查代码质量、排查潜在问题、评估架构健康度时激活。按望闻问切治沉六步进行系统性检查与修复。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
项目体检技能。在需要审查代码质量、排查潜在问题、评估架构健康度时激活。按望闻问切治沉六步进行系统性检查与修复。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
GitHub Release 发布操作规范。在需要发布版本、上传安装包到 GitHub Release 时激活,确保使用正确的命令和流程。
确认/删除等交互弹框统一使用 showTolyPopPicker 底部弹出样式。在需要弹出确认框、删除确认、操作选择时激活,确保交互风格一致。
后端服务启动与数据库操作规范。在需要启动后端服务、运行 API 测试、执行数据库迁移或遇到连接错误时激活,确保使用正确的命令和流程。
功能归档规范。在归档功能版本、更新功能网、创建存档快照时激活,确保节点编号正确、网络图完整。
使用 tolyui_mediax 实现媒体预览。适用于图片九宫格展示、全屏预览、手势缩放、视频播放、Hero 动画等场景。
Flutter Widget/Page 组件代码评审技能。在需要审查组件代码质量、发现设计问题时激活,确保输出结构化的问题清单和改进建议。
| name | project-doctor |
| description | 项目体检技能。在需要审查代码质量、排查潜在问题、评估架构健康度时激活。按望闻问切治沉六步进行系统性检查与修复。 |
| metadata | {"model":"manual","last_modified":"Sat, 17 May 2026 00:00:00 GMT"} |
你是这个项目的主治医生。你的工作不是写新功能,而是检查项目的健康状况,找出潜藏的问题,给出诊断和处方,并协助修复。
六步闭环:望 → 闻 → 问 → 切 → 治 → 沉。
运行统计脚本,产出模块文件数、行数、字符数、占比、大文件排行。
python scripts/checkup/client_stats.py # 前端
python scripts/checkup/server_stats.py # 后端
产出:docs/project/checkup/{tag}/{端}/01_望_结构统计.md
结构审查要点:
运行静态分析脚本,产出 error/warning/info 分类统计。
python scripts/checkup/client_analyze.py # 前端(flutter analyze)
python scripts/checkup/server_analyze.py # 后端(cargo clippy)
产出:docs/project/checkup/{tag}/{端}/02_闻_静态分析.md
解读要点:
深入阅读关键模块代码,结合望、闻结果,产出代码质量报告。
产出:docs/project/checkup/{tag}/{端}/03_问_代码审查.md
审查维度:
审查范围(按优先级):
针对前三步的疑似问题逐一确认,产出确诊清单和医嘱。
产出:docs/project/checkup/{tag}/{端}/04_切_确诊处方.md
分级:
用户说"开始处理问题"时进入此阶段。
流程:
{tag}_fix),不打 tagflutter analyze / cargo clippy 验证产出:docs/project/checkup/{tag}/{端}/05_治_修复记录.md
将修复过程中的经验教训写入 steering,防止同类问题复发。
操作:
.kiro/steering/flutter/ 或 .kiro/steering/rust/原则:体检报告的终极归宿不是躺在 docs 里吃灰,而是化为项目的免疫系统。
docs/project/checkup/{tag}/
├── client/
│ ├── 01_望_结构统计.md
│ ├── 02_闻_静态分析.md
│ ├── 03_问_代码审查.md
│ ├── 04_切_确诊处方.md
│ └── 05_治_修复记录.md
└── server/
├── 01_望_结构统计.md
├── 02_闻_静态分析.md
├── 03_问_代码审查.md
├── 04_切_确诊处方.md
└── 05_治_修复记录.md