Files
Nexus/.cursor/skills/writing-plans/plan-document-reviewer-prompt.md
T
Your Name cdd0be328a fix: 六轮深度扫描 — 47项Bug修复、安全加固、死代码清理
Critical runtime bugs:
- terminal.html WebSSH完全不可用(URL前缀/JSON解析/Content-Type三处错误)
- servers.py路由遮蔽:/logs被/{id}拦截,3个前端页面同步日志查询失败
- scripts.html startExecPoll()→startExecPolling(),长任务快速执行崩溃
- agent.py {value!r!s:.50}格式串非法,agent发非数值时ValueError
- alerts.html d.daily.reduce()无null检查,API返回空数据时TypeError

Resource leak / stability:
- websocket.py僵尸连接未关闭TCP,文件描述符泄漏
- websocket.py _last_alert_time字典无限增长(加1小时过期清理)
- asyncssh_pool.py全忙时超过MAX_CONNECTIONS无限增长
- self_monitor.py Telegram告警无冷却,宕机时每30秒刷屏
- schedule_runner.py一次性调度执行超60秒会重复触发
- 限速脚本EXPIRE每次重置窗口可绕过(改用Lua原子脚本)

Security:
- JWT access token加token_version声明,改密码后旧token立失效(零宽限)
- INSTALL_MODE导入时常量→动态函数,安装后JWT认证不再残留禁用
- install.py /lock端点加管理员存在性验证,防止阻断安装
- ServerUpdate schema移除connectivity只读字段,防止伪造连接状态

Frontend fixes:
- doExec()缺r.ok检查、commands.html null检查
- _server_to_dict()补last_checked_at+ssh_key_public
- _field_match()逗号cron表达式修复
- alerts类型显示、SSH会话名称、搜索高亮定位
- 一次性/循环定时任务(run_mode+fire_at+自动禁用)

Dead code removed (400+ lines):
- SyncService batch_push/_push_single等5个方法(零调用者)
- 5个未使用schema(SyncCommands/SyncConfig/SyncSftp/FileDeploy/PaginatedResponse)
- 6个零调用service方法、3个无前端API端点
- 4个未使用import

Schema migrations:
- push_schedules: run_mode + fire_at列,cron_expr改NULL
- servers: 7个新列 + ssh_key_private/public VARCHAR(500)→TEXT

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-05-24 16:26:40 +08:00

1.6 KiB

计划文档审查员提示模板

调度计划文档审查员子代理时使用此模板。

用途: 验证计划是否完整、与规格匹配,并且任务分解合理。

调度时机: 完整计划编写完成后。

Task tool(通用):
  description: "审查计划文档"
  prompt: |
    你是一名计划文档审查员。验证此计划是否完整并准备好进行实现。

    **待审查计划:** [PLAN_FILE_PATH]
    **参考规格:** [SPEC_FILE_PATH]

    ## 检查内容

    | 类别 | 检查要点 |
    |------|----------|
    | 完整性 | TODO、占位符、不完整的任务、缺失的步骤 |
    | 规格对齐 | 计划覆盖了规格需求,没有重大范围蔓延 |
    | 任务分解 | 任务有清晰的边界,步骤可执行 |
    | 可构建性 | 工程师能否按此计划执行而不会卡住? |

    ## 校准标准

    **只标记会在实现阶段造成实际问题的事项。**
    实现者构建了错误的东西或卡住了——这是问题。
    措辞上的小改进、风格偏好和"锦上添花"的建议则不是。

    除非存在严重缺陷——规格中的需求遗漏、
    矛盾的步骤、占位内容、或者模糊到无法执行的任务——否则应予以通过。

    ## 输出格式

    ## 计划审查

    **状态:** 通过 | 发现问题

    **问题(如有):**
    - [任务 X,步骤 Y]:[具体问题] - [为什么这对实现很重要]

    **建议(仅供参考,不阻止通过):**
    - [改进建议]

审查员返回: 状态、问题(如有)、建议