@runweave/server-linux-x64 0.1.8 → 0.1.9

package/payload/plugins/toolkit/skills/prototype-first-development/references/html-prototype-template/README.md

@@ -0,0 +1,88 @@
+# 原型标题
+
+面向 `<feature>` 的可运行 HTML 交互原型。
+
+## 启动
+
+```bash
+python3 -m http.server 6188 --directory docs/prototypes/<feature-slug>
+```
+
+打开：
+
+```text
+http://127.0.0.1:6188/
+```
+
+## 文件
+
+- `index.html`：静态页面壳层、样式和挂载点。
+- `app.js`：原型状态流转和事件处理。
+- `mock-state.json`：模拟领域对象、UI 状态和事件流。
+- `prototype-preview.png`：可选的验证截图。
+
+## 原型简报
+
+- 目标：
+- 用户动作：
+- 主要用户：
+- 影响的产品界面或模块：
+- 关键流程：
+- 重要状态：
+- 非目标：
+
+## 验证点
+
+- 用户可以从首屏完成主要流程。
+- 不阅读实现代码，也能看出状态变化。
+- 首屏只包含最终产品会出现的 UI、文案和操作入口。
+- 原型不把快捷键说明、操作教程、需求备注或 mock 控制器画进产品界面。
+- 如存在 prototype helper，它默认隐藏，且与最终产品 UI 的边界清晰。
+
+## 功能分类
+
+### 产品核心功能
+
+| 元素 / 行为 | 最终产品是否需要 | 产品价值 | 备注 |
+| ----------- | ---------------- | -------- | ---- |
+|             | 是               |          |      |
+
+### 原型辅助功能
+
+| 元素 / 行为 | 辅助验证什么 | 为什么不进入产品 | 备注 |
+| ----------- | ------------ | ---------------- | ---- |
+|             |              |                  |      |
+
+## 调整记录
+
+| 轮次 | 调整内容 | 原因 | 结果 |
+| ---- | -------- | ---- | ---- |
+| 1    |          |      |      |
+
+## 冻结记录
+
+- 最终采用的交互：
+- 放弃的方向：
+- 产品核心功能清单是否已确认：
+- 原型辅助功能清单是否已确认：
+- 最终截图：
+- 冻结时间：
+
+## 边界
+
+- 这个原型不连接真实后端 API。
+- 这个原型不导入生产源码。
+- 这个原型不能证明产品协议、存储或运行时支持已经存在。
+- 原型专用控件只允许出现在 README、URL 参数或默认隐藏的 helper 面板中，不是最终产品 UI。
+- 原型辅助功能默认不进入实施计划，除非在冻结记录中明确转为产品需求。
+
+## 实施计划衔接
+
+- 原型表达的产品行为：
+- 需要进入产品实现的核心功能：
+- 不进入产品实现的原型辅助功能：
+- 需要检查的现有代码：
+- 可能涉及的协议或数据结构：
+- 可能涉及的前端落点：
+- 可能涉及的后端或运行时落点：
+- 验收方式：

package/payload/plugins/toolkit/skills/prototype-first-development/references/html-prototype-template/app.js

@@ -0,0 +1,145 @@
+/* global URLSearchParams, document, fetch, window */
+
+const app = document.querySelector("#app");
+
+function render(state) {
+  const activeView = state.views.find((view) => view.id === state.activeViewId);
+  const showPrototypeControls = new URLSearchParams(window.location.search).has(
+    "prototypeControls",
+  );
+
+  app.innerHTML = `
+    <header class="topbar">
+      <div class="title">
+        <strong>${state.title}</strong>
+        <span>${state.subtitle}</span>
+      </div>
+      <div class="toolbar">
+        ${state.actions
+          .map(
+            (action) => `
+              <button class="button ${action.primary ? "primary" : ""}" data-action-id="${action.id}">
+                ${action.label}
+              </button>
+            `,
+          )
+          .join("")}
+      </div>
+    </header>
+    <section class="product-shell">
+      <aside class="sidebar">
+        <nav class="nav-list" aria-label="${state.navigationLabel}">
+          ${state.views
+            .map(
+              (view) => `
+                <button
+                  class="nav-item ${view.id === state.activeViewId ? "active" : ""}"
+                  data-view-id="${view.id}"
+                >
+                  ${view.label}
+                </button>
+              `,
+            )
+            .join("")}
+        </nav>
+      </aside>
+      <div class="main-panel">
+        <section class="stage">
+          <div class="stage-header">
+            <strong>${activeView.title}</strong>
+            <span>${activeView.status}</span>
+          </div>
+          <div class="stage-body">
+            ${activeView.items
+              .map(
+                (item) => `
+                  <article class="item">
+                    <h2>${item.title}</h2>
+                    <p>${item.description}</p>
+                  </article>
+                `,
+              )
+              .join("")}
+          </div>
+        </section>
+      </div>
+    </section>
+    <aside
+      class="prototype-controls ${showPrototypeControls ? "visible" : ""}"
+      data-prototype-helper="true"
+      aria-hidden="${showPrototypeControls ? "false" : "true"}"
+    >
+      <div class="prototype-controls-inner">
+        <span>Prototype helper, not product UI</span>
+        <div>
+          ${state.views
+            .map(
+              (view) => `
+                <button class="button" data-view-id="${view.id}">
+                  ${view.label}
+                </button>
+              `,
+            )
+            .join("")}
+        </div>
+      </div>
+    </aside>
+  `;
+}
+
+function bindInteractions(initialState) {
+  let state = initialState;
+  render(state);
+
+  app.addEventListener("click", (event) => {
+    const target = event.target.closest("button");
+    if (!target) return;
+
+    if (target.dataset.actionId) {
+      state = {
+        ...state,
+        lastActionId: target.dataset.actionId,
+      };
+      render(state);
+      return;
+    }
+
+    if (target.dataset.viewId) {
+      state = {
+        ...state,
+        activeViewId: target.dataset.viewId,
+      };
+      render(state);
+    }
+  });
+}
+
+function renderLoadError(error) {
+  app.innerHTML = "";
+
+  const panel = document.createElement("pre");
+  panel.style.margin = "0";
+  panel.style.padding = "18px";
+  panel.style.color = "var(--danger)";
+  panel.style.whiteSpace = "pre-wrap";
+  panel.textContent = [
+    "无法加载 mock-state.json。",
+    "",
+    String(error),
+    "",
+    "请用以下命令启动原型，而不是直接打开本地文件：",
+    "python3 -m http.server 6188 --directory docs/prototypes/<feature-slug>",
+  ].join("\n");
+
+  app.append(panel);
+}
+
+fetch("./mock-state.json")
+  .then((response) => {
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  })
+  .then(bindInteractions)
+  .catch(renderLoadError);

package/payload/plugins/toolkit/skills/prototype-first-development/references/html-prototype-template/index.html

@@ -0,0 +1,229 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>原型标题</title>
+    <style>
+      :root {
+        color-scheme: dark;
+        --bg: #0b1020;
+        --surface: #111827;
+        --surface-2: #172033;
+        --line: #2b364d;
+        --text: #eef2f8;
+        --muted: #9aa6bb;
+        --accent: #38bdf8;
+        --accent-weak: rgba(56, 189, 248, 0.16);
+        --success: #34d399;
+        --danger: #fb7185;
+        --radius: 8px;
+        font-family:
+          Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+          "Segoe UI", sans-serif;
+      }
+
+      * {
+        box-sizing: border-box;
+      }
+
+      body {
+        margin: 0;
+        min-height: 100vh;
+        background: var(--bg);
+        color: var(--text);
+      }
+
+      button {
+        border: 0;
+        color: inherit;
+        cursor: pointer;
+        font: inherit;
+      }
+
+      .app {
+        min-height: 100vh;
+        display: grid;
+        grid-template-rows: 52px 1fr;
+      }
+
+      .topbar {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 16px;
+        padding: 0 18px;
+        border-bottom: 1px solid var(--line);
+        background: rgba(11, 16, 32, 0.96);
+      }
+
+      .title {
+        min-width: 0;
+        display: flex;
+        flex-direction: column;
+        gap: 2px;
+      }
+
+      .title strong,
+      .title span {
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+      }
+
+      .title span {
+        color: var(--muted);
+        font-size: 12px;
+      }
+
+      .toolbar {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+      }
+
+      .button {
+        min-height: 32px;
+        padding: 0 12px;
+        border-radius: 7px;
+        background: var(--surface-2);
+        color: var(--text);
+      }
+
+      .button.primary {
+        background: var(--accent);
+        color: #03111a;
+        font-weight: 700;
+      }
+
+      .product-shell {
+        min-height: 0;
+        display: grid;
+        grid-template-columns: 220px minmax(0, 1fr);
+      }
+
+      .sidebar {
+        min-width: 0;
+        border-right: 1px solid var(--line);
+        background: #080d19;
+        padding: 14px;
+      }
+
+      .nav-list {
+        display: grid;
+        gap: 6px;
+      }
+
+      .nav-item {
+        min-height: 34px;
+        width: 100%;
+        padding: 0 10px;
+        border-radius: 7px;
+        background: transparent;
+        color: var(--muted);
+        text-align: left;
+      }
+
+      .nav-item.active {
+        background: var(--accent-weak);
+        color: var(--text);
+      }
+
+      .main-panel {
+        min-width: 0;
+        padding: 18px;
+        display: grid;
+        grid-template-rows: auto 1fr;
+        gap: 14px;
+      }
+
+      .stage {
+        min-height: 0;
+        border: 1px solid var(--line);
+        border-radius: var(--radius);
+        background: var(--surface);
+        overflow: hidden;
+      }
+
+      .stage-header {
+        min-height: 44px;
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        gap: 12px;
+        padding: 0 14px;
+        border-bottom: 1px solid var(--line);
+      }
+
+      .stage-header span {
+        color: var(--muted);
+        font-size: 13px;
+      }
+
+      .stage-body {
+        padding: 16px;
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+        gap: 12px;
+      }
+
+      .item {
+        min-height: 120px;
+        padding: 14px;
+        border: 1px solid var(--line);
+        border-radius: var(--radius);
+        background: #0f172a;
+      }
+
+      .item h2 {
+        margin: 0 0 8px;
+        font-size: 15px;
+      }
+
+      .item p {
+        margin: 0;
+        color: var(--muted);
+        font-size: 13px;
+        line-height: 1.5;
+      }
+
+      .prototype-controls {
+        display: none;
+        border-top: 1px solid var(--line);
+        background: #030712;
+        padding: 16px;
+      }
+
+      .prototype-controls.visible {
+        display: block;
+      }
+
+      .prototype-controls-inner {
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        gap: 8px;
+      }
+
+      .prototype-controls span {
+        color: var(--muted);
+        font-size: 12px;
+      }
+
+      @media (max-width: 860px) {
+        .product-shell {
+          grid-template-columns: 1fr;
+        }
+
+        .sidebar {
+          border-right: 0;
+          border-bottom: 1px solid var(--line);
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <main id="app" class="app"></main>
+    <script type="module" src="./app.js"></script>
+  </body>
+</html>

package/payload/plugins/toolkit/skills/prototype-first-development/references/html-prototype-template/mock-state.json

@@ -0,0 +1,60 @@
+{
+  "title": "原型标题",
+  "subtitle": "当前产品区域",
+  "navigationLabel": "主要导航",
+  "activeViewId": "primary",
+  "actions": [
+    {
+      "id": "secondary",
+      "label": "次要操作",
+      "primary": false
+    },
+    {
+      "id": "primary",
+      "label": "主要操作",
+      "primary": true
+    }
+  ],
+  "views": [
+    {
+      "id": "primary",
+      "label": "主视图",
+      "title": "主要内容",
+      "status": "进行中",
+      "items": [
+        {
+          "title": "核心对象",
+          "description": "对象的当前状态、主要字段和可执行动作。"
+        },
+        {
+          "title": "状态反馈",
+          "description": "用户完成操作后可见的状态变化。"
+        }
+      ]
+    },
+    {
+      "id": "secondary",
+      "label": "次视图",
+      "title": "关联内容",
+      "status": "就绪",
+      "items": [
+        {
+          "title": "关联对象",
+          "description": "与当前流程相关的补充信息。"
+        }
+      ]
+    },
+    {
+      "id": "empty",
+      "label": "空状态",
+      "title": "暂无内容",
+      "status": "待处理",
+      "items": [
+        {
+          "title": "空状态提示",
+          "description": "无数据时用户需要看到的反馈和后续入口。"
+        }
+      ]
+    }
+  ]
+}

package/payload/plugins/toolkit/skills/prototype-first-development/references/implementation-plan-handoff-template.md

@@ -0,0 +1,61 @@
+# 原型到实施计划交接模板
+
+当原型已经冻结，并且用户要求进入计划或实现阶段时，按这个结构整理信息。实际计划落盘时优先结合 `$toolkit:write-plan`。
+
+Runweave 仓库默认路径约定：
+
+- 原型资产：`docs/prototypes/<feature-slug>/`
+- 实施计划：`docs/plans/YYYY-MM-DD-<feature-slug>.md`
+
+## 原型资产
+
+- 原型目录：
+- 对应计划路径：
+- 启动命令：
+- 最终截图：
+- 最终截图是否排除 prototype helper：
+- 冻结时间：
+
+## 原型结论
+
+- 最终采用的交互：
+- 关键用户动作：
+- 关键状态：
+- 产品核心功能：
+- 原型辅助功能：
+- 明确非目标：
+- 被放弃的方向：
+
+## 产品行为
+
+- 用户可见行为：
+- 输入：
+- 输出：
+- 状态流转：
+- 错误或空状态：
+
+## 当前代码核查
+
+- 需要读取的前端文件：
+- 需要读取的后端文件：
+- 需要读取的协议或共享类型：
+- 需要读取的存储、运行时或事件流：
+- 已确认支持的能力：
+- 仍缺失的能力：
+
+## 实施范围
+
+- 前端修改：
+- 后端修改：
+- 协议或类型修改：
+- 文档修改：
+- 明确不实现的原型辅助功能：
+- 明确不实现的说明文字或演示控件：
+- 不做什么：
+
+## 验收方式
+
+- 浏览器验证：
+- 命令验证：
+- 手工检查：
+- 失败判断：

package/payload/plugins/toolkit/skills/prototype-first-development/references/prototype-workflow-checklist.md

@@ -0,0 +1,64 @@
+# 原型先行开发检查清单
+
+使用这个清单检查一次原型先行流程是否跑完整。不要把它当作普通说明文；它是阶段门禁。
+
+## 1. 原型简报
+
+- 是否写清楚用户目标、用户动作、关键状态和非目标？
+- 是否写清楚原型要影响的真实产品界面或模块？
+- 是否初步区分了产品核心功能和原型辅助功能？
+- 是否避免一开始就讨论生产代码实现细节？
+
+## 2. 可运行原型
+
+- 是否生成到 `docs/prototypes/<feature-slug>/`？
+- 是否包含 `README.md`、`index.html`、`app.js`、`mock-state.json`？
+- 是否可以通过 `python3 -m http.server` 打开？
+- 是否只模拟关键路径，没有连接真实后端？
+- 是否把 mock 数据放在 JSON，而不是散落在页面字符串里？
+- 首屏是否像最终产品界面，而不是带说明文字、需求备注或操作教程的草稿？
+- 是否没有把“快捷键说明”“这里展示”“模拟状态”“下一步演示”等非产品文案画进产品 UI？
+- 所有可见按钮、输入、菜单和状态是否都是最终产品计划保留的入口或反馈？
+- 每个按钮、面板、状态标签，以及如存在的事件流或模拟开关，是否都能归类为产品核心功能或原型辅助功能？
+
+## 3. 调整循环
+
+- 用户反馈时，是否只调整原型，不碰产品代码？
+- 每轮调整是否更新 README 的调整记录？
+- 是否保持函数、状态、样式命名可读？
+- 是否避免引入真实项目组件和复杂依赖？
+- 如需新增演示控件，是否优先放在 README、URL 参数或默认隐藏的 helper 面板，而不是产品画面？
+- 新增的演示控件是否与产品画面视觉隔离，并同步写入“原型辅助功能”表？
+- 新增的产品能力是否同步写入“产品核心功能”表？
+
+## 4. 原型冻结
+
+- README 是否记录最终采用的交互？
+- README 是否记录放弃的方向和原因？
+- README 是否确认产品核心功能清单？
+- README 是否确认原型辅助功能清单？
+- README 是否确认最终截图不包含原型说明、演示脚手架或不进产品的辅助控件？
+- 浏览器验证重要时，是否保存最终截图？
+- 在 Runweave 仓库中，是否使用 `$toolkit:playwright-cli` 完成浏览器页面复现、修复或验收？
+
+## 5. 实施计划
+
+- 计划是否引用原型目录？
+- 计划是否区分“原型表达的意图”和“当前代码是否支持”？
+- 计划是否只承接产品核心功能？
+- 原型辅助功能是否明确列为不进入产品实现？
+- 计划是否没有把原型 README、helper 面板或 mock 控制器里的说明内容写成产品需求？
+- 是否先检查真实代码，再写协议、后端、运行时、前端落点？
+- 是否写清验收方式和失败判断？
+
+## 6. 产品实现
+
+- 是否只在用户明确推进实现后修改产品代码？
+- 是否没有把原型代码直接照搬进生产代码？
+- 是否没有把原型辅助功能误实现进产品？
+- 是否用真实代码现状校准可行性？
+- 是否验证了原型冻结的关键交互？
+
+## 偏差处理
+
+如果发现已经提前改了产品代码、跳过了原型冻结、没有把模板放在技能引用目录下，或没有区分产品核心功能与原型辅助功能，先停下来修正流程产物，再继续后续阶段。