Aitishiku.com📌 Skill基础信息
Skill名称：weline-framework-runtime
简称：Weline 运行时管理
来源：社区第三方（Aiweline）
运行宿主：Claude-Code CLI
核心定位：为 WelineFramework 项目提供运行时进程管理能力，包括服务启停、状态管理、进程编排和调试功能，适合 PHP 项目开发和运维场景。
🧩 内部核心组成
该 Skill 主要提供以下核心能力：
知识文档体系：
references/runtime-basics.md- 运行时基础概念references/session-runtime.md- 会话运行时管理- 相关规则文件：WLS 状态管理规则
核心管理功能：
| 功能类型 | 关键命令/操作 | 功能简述 |
|---|---|---|
| 服务控制 | server:start | 启动 Weline 服务 |
| 服务控制 | server:reload | 重载服务（业务代码变更） |
| 服务控制 | server:restart | 重启服务（运行时配置变更） |
| 进程管理 | Worker 管理 | 工作进程生命周期管理 |
| 进程管理 | Dispatcher 调度 | 请求分发器管理 |
| 状态管理 | StateManager | 运行时状态重置与维护 |
| 会话服务 | Session Server | 会话服务器管理 |
| 内存服务 | Memory Service | 内存服务管理 |
| 运维功能 | Maintenance Mode | 维护模式切换 |
目录结构依赖：
- 默认工作目录：
E:\WelineFramework\DEV-workspace - 引用文档路径：
references/目录下相关文档 - 技能规则路径：
dev/ai/skills/相关技能文件
🛠 安装与启用方式
安装命令：
skills install --user Aiweline/WelineFramework前置要求：
- 已部署 WelineFramework 项目环境
- 配置正确的项目工作目录路径
- PHP 运行环境支持
启动方式：通过 Claude-Code CLI 触发相关运行时管理命令
📋 标准工作流
- 需求识别：当任务涉及 WLS、Worker、Dispatcher、服务启停、维护模式等关键词时自动触发
- 文档查阅：优先阅读 runtime-basics.md 了解基础概念，涉及会话时查阅 session-runtime.md
- 命令执行：
- 业务代码变更 → 执行 php bin/w server:reload
- 运行时配置变更 → 执行 php bin/w server:restart
- 状态验证：检查 worker、dispatcher、orchestrator 等组件的状态重置行为
- 问题排查：联合检查维护模式、健康检查路径等运行时状态
⚠️ 关键限制、缺陷、注意事项
平台限制：
- 仅支持 Windows 环境（工作目录为 E:\ 驱动器）
- 依赖特定的 WelineFramework 项目结构
使用约束：
- reload 与 restart 有明确区分：reload 用于业务代码变更，restart 用于运行时配置变更
- WLS 环境下需要特别关注请求级静态状态的重置行为
- 需要预先设置正确的开发工作空间路径
生产适用性：适用于开发测试环境，生产环境需要额外的稳定性验证
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景：
- WelineFramework 项目的本地开发调试
- PHP 应用服务器的进程管理需求
- 需要频繁重载/重启服务的开发工作流
- 会话管理和状态维护的调试场景
❌ 不适合场景：
- 非 WelineFramework 项目
- Linux/macOS 开发环境
- 生产环境直接使用（需经过定制化改造）
- 非 PHP 技术栈的项目管理
如何安装
skills install --user Aiweline/WelineFramework通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。