@aipper/aiws-spec 0.0.46 → 0.0.48

package/templates/workspace/.opencode/lib/aiws-context.js

@@ -386,6 +386,209 @@ export class AiwsContext {
     )
   }
 
+  // -- Goal FSM (TOOLING-003D L1 inject) -------------------------------
+
+  /**
+   * Scan `.aiws/goals/*.state.json` for active/paused goals.
+   * Preference: status=active first, then paused.
+   * Within a status tier, most recently updated wins (updated_at ISO or file mtime).
+   *
+   * Returns array of goal summary objects (may be empty). Never throws.
+   * Each entry:
+   *   { goal_id, status, current_phase, checkpoint_summary, md_path, state_path,
+   *     next_action, updated_at, mtime_ms, others_note? }
+   */
+  getActiveGoals() {
+    const goalsDir = join(this.directory, ".aiws", "goals")
+    if (!existsSync(goalsDir)) return []
+
+    let files
+    try {
+      files = readdirSync(goalsDir).filter(f => f.endsWith(".state.json"))
+    } catch {
+      return []
+    }
+
+    const active = []
+    const paused = []
+
+    for (const file of files) {
+      const statePath = join(goalsDir, file)
+      let raw
+      try {
+        raw = readFileSync(statePath, "utf-8")
+      } catch {
+        continue
+      }
+
+      let state
+      try {
+        state = JSON.parse(raw)
+      } catch {
+        // malformed JSON — skip without crashing
+        continue
+      }
+      if (!state || typeof state !== "object") continue
+
+      const status = str(state.status)
+      if (status !== "active" && status !== "paused") continue
+
+      const goalId =
+        str(state.goal_id) ||
+        str(state.goalId) ||
+        file.replace(/\.state\.json$/, "")
+
+      let mtimeMs = 0
+      try {
+        mtimeMs = statSync(statePath).mtimeMs
+      } catch {
+        mtimeMs = 0
+      }
+
+      const updatedAt = str(state.updated_at) || str(state.updatedAt) || null
+      let sortKey = mtimeMs
+      if (updatedAt) {
+        const t = Date.parse(updatedAt)
+        if (!Number.isNaN(t)) sortKey = t
+      }
+
+      const currentPhase =
+        state.current_phase == null
+          ? null
+          : (str(state.current_phase) || String(state.current_phase))
+
+      const checkpointSummary = this._summarizeGoalCheckpoints(state.checkpoints)
+      const mdPath = join(".aiws", "goals", `${goalId}.md`)
+      const nextAction = this._suggestGoalNextAction({
+        goal_id: goalId,
+        status,
+        current_phase: currentPhase,
+        checkpoints: state.checkpoints,
+      })
+
+      const entry = {
+        goal_id: goalId,
+        status,
+        current_phase: currentPhase,
+        checkpoint_summary: checkpointSummary,
+        md_path: mdPath,
+        state_path: join(".aiws", "goals", file),
+        next_action: nextAction,
+        updated_at: updatedAt,
+        mtime_ms: mtimeMs,
+        _sort: sortKey,
+      }
+
+      if (status === "active") active.push(entry)
+      else paused.push(entry)
+    }
+
+    const byRecency = (a, b) => b._sort - a._sort
+    active.sort(byRecency)
+    paused.sort(byRecency)
+
+    const ordered = [...active, ...paused]
+    return ordered.map(({ _sort, ...rest }) => rest)
+  }
+
+  /**
+   * Primary goal for session inject: first of getActiveGoals() (active preferred).
+   * When multiple actives exist, the most recently updated is primary; callers can
+   * list others via getActiveGoals().
+   */
+  getActiveGoal() {
+    const goals = this.getActiveGoals()
+    return goals.length > 0 ? goals[0] : null
+  }
+
+  _summarizeGoalCheckpoints(checkpoints) {
+    if (!checkpoints || typeof checkpoints !== "object") return "(no checkpoints)"
+    const pending = []
+    const complete = []
+    for (const [name, cp] of Object.entries(checkpoints)) {
+      const st =
+        cp && typeof cp === "object"
+          ? str(cp.status) || "unknown"
+          : "unknown"
+      if (st === "complete" || st === "done") complete.push(name)
+      else pending.push(`${name}:${st}`)
+    }
+    const parts = []
+    if (pending.length) parts.push(`pending=[${pending.join(", ")}]`)
+    if (complete.length) parts.push(`complete=${complete.length}`)
+    return parts.join(" ") || "(empty checkpoints)"
+  }
+
+  /**
+   * Suggest next_action text for L1 inject (READ-ONLY; no skill execution).
+   * Frozen Q3=A: plugins only inject text; model/user runs /ws-goal.
+   */
+  _suggestGoalNextAction({ goal_id, status, current_phase, checkpoints }) {
+    const id = goal_id || "?"
+    if (status === "paused") {
+      return `/ws-goal resume ${id}`
+    }
+    // active
+    if (!current_phase || current_phase === "null") {
+      return `/ws-goal continue ${id} (establish current_phase via advance if needed)`
+    }
+    // Find first incomplete checkpoint name if useful
+    let nextCp = null
+    if (checkpoints && typeof checkpoints === "object") {
+      for (const [name, cp] of Object.entries(checkpoints)) {
+        const st =
+          cp && typeof cp === "object" ? str(cp.status) : null
+        if (st && st !== "complete" && st !== "done") {
+          nextCp = name
+          break
+        }
+      }
+    }
+    if (nextCp && nextCp !== current_phase) {
+      return `/ws-goal continue ${id} — phase=${current_phase}, next checkpoint=${nextCp}`
+    }
+    return `/ws-goal continue ${id} — phase=${current_phase}`
+  }
+
+  /**
+   * Compact <goal-context> block for session-start inject.
+   * Empty string when no active/paused goal.
+   */
+  buildGoalContextBlock() {
+    const goals = this.getActiveGoals()
+    if (!goals.length) return ""
+
+    const primary = goals[0]
+    const others = goals.slice(1)
+    const lines = [
+      "<goal-context>",
+      "## Active / Paused Goal (FSM L1 inject — advisory routing only)",
+      `goal_id: ${primary.goal_id}`,
+      `status: ${primary.status}`,
+      `current_phase: ${primary.current_phase ?? "null"}`,
+      `checkpoints: ${primary.checkpoint_summary}`,
+      `goal_md: ${primary.md_path}`,
+      `state: ${primary.state_path}`,
+      `next_action: ${primary.next_action}`,
+    ]
+    if (others.length) {
+      const brief = others
+        .map(g => `${g.goal_id}(${g.status}, phase=${g.current_phase ?? "null"})`)
+        .join("; ")
+      lines.push(`other_goals: ${brief}`)
+      lines.push(
+        "note: multiple active/paused — primary is most recently updated; " +
+          "resolve conflict before parallel goal work"
+      )
+    }
+    lines.push(
+      "authority: phase writes via `aiws goal advance` only; " +
+        "this block does not execute skills (L1 text inject)."
+    )
+    lines.push("</goal-context>")
+    return lines.join("\n")
+  }
+
   // -- Spec index ------------------------------------------------
 
   /**
@@ -824,6 +1027,14 @@ You are starting a new session in an aiws-managed project.
 Read and follow the context below.
 </aiws-context>`)
 
+  // TOOLING-003D L1: active/paused goal FSM inject (READ-ONLY text)
+  try {
+    const goalBlock = ctx.buildGoalContextBlock()
+    if (goalBlock) parts.push(goalBlock)
+  } catch {
+    // Non-blocking: goal inject must never crash session-start
+  }
+
   const specIndex = ctx.getSpecIndex()
   if (specIndex) {
     parts.push("<spec-index>")

package/templates/workspace/.opencode/skills/using-aiws/SKILL.md

@@ -5,21 +5,21 @@ description: 使用时机：新会话开始、不确定下一步做什么时。
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：默认入口，先读真值文件，判定当前任务 workflow，再进入具体 `ws-*` skill。若意图不明确：先澄清，不直接进入实现。
+目标：默认入口，先读真值，判定 workflow，再进入 `ws-*`。意图不明则先澄清，不直接实现。阶段：bootstrap/router，只分流。
 
-阶段定位：bootstrap/router 阶段；负责分流，不直接完成实现。
+路由 SSOT：`packages/spec/docs/workflow-router-rules.json`（`goal_driven` / `plan_first` / `direct_implementation` / `escape_hatch`）。本 skill 是人工投影，冲突以 JSON 为准。
 
 ## 编排约束
 
-- **不直接实现**：只判 workflow、读真值、路由到对应 `ws-*`。主 session 不直接写代码。
-- **上下文先于判决**：路由 `direct_implementation` 前必须收集项目上下文——`git status --porcelain`（改动文件数）、`git diff --stat`（改动行范围）、`AI_WORKSPACE.md` 验证入口。仅当 ≤3 文件、≤100 行改动、验证明确时，才可判 direct。
-- **意图不明先澄清**：`routeTo=clarify` 时必须停止并问 1-3 个关键问题，不猜测。
+- **不直接实现**：只判 workflow、读真值、路由到 `ws-*`。主 session 不写代码。
+- **上下文先于判决**：`direct_implementation` 前收集 `git status --porcelain`、`git diff --stat`、`AI_WORKSPACE.md` 验证入口；仅 ≤3 文件、≤100 行、验证明确才可 direct。
+- **意图不明先澄清**：`routeTo=clarify` 时停并问 1-3 个关键问题。
+- **L3 纪律（goal resume）**：有 `active`/`paused` goal 时，冷启动 medium+ 勿 bare 跳 `$ws-dev`/`$ws-plan`；优先 `$ws-goal` resume。例外：显式 escape-hatch 或用户点名阶段 skill。
 
 ## 必需输入
 
-- 当前任务描述
-- `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
-- 若已存在：`change/<change-id>` 上下文、`plan/...`、`.aiws/changes/<change-id>/...`
+- 任务描述；`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
+- 若已存在：`change/<id>`、`plan/...`、`.aiws/changes/<id>/...`、`.aiws/goals/`、`ws-goal` skill
 
 ## 必需输出
 
@@ -27,83 +27,74 @@ description: 使用时机：新会话开始、不确定下一步做什么时。
 
 ## 阻断条件
 
-- 无法确定项目根目录、缺失任一真值文件、无法明确任务意图、无法归因且不能安全推断
+- 无法确定项目根、缺失真值、意图不明、无法归因且不能安全推断
 
 ## 执行步骤
 
 ### 1. Preflight
 
-读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`。若检测到 `.opencode/oh-my-opencode.json` 输出 `oMo-enabled`，否则 `standard-opencode`。缺失真值文件则 route = `$ws-preflight`，建议 `aiws init .`
+读三真值。有 `.opencode/oh-my-opencode.json` → `oMo-enabled`，否则 `standard-opencode`。缺真值 → `$ws-preflight`，建议 `aiws init .`。
 
 ### 1.5 Per-turn Breadcrumb（必做）
 
-每轮对话开始时读取当前 change 状态，输出 `[workflow-state:PHASE_NAME/N]` 标记。
+每轮开始读 change 状态，输出 `[workflow-state:PHASE_NAME/N]`。
 
 ### 2. 路由判定
 
-根据 `packages/spec/docs/workflow-router-rules.json` 判定。判 direct_implementation 前必须先收集上下文（git status、涉及文件范围）：
+按 `workflow-router-rules.json` 判定。direct 前先收集 git 上下文。
 
-- ≤2 文件且均在已知路径 → direct
-- ≥3 文件或含未知路径 → ws-plan
+**复杂度启发（结合上下文）：** ≤2 文件、已知路径、≤100 行、验证明确 → 可 direct；≥3 文件 / 跨模块 / 多步 / 未知路径 → medium+（优先 goal/plan）。
+
+**ws-goal 可用**：存在 `.aiws/goals/`，或可加载 `ws-goal` skill。
 
 | 意图 | Route |
 |------|-------|
 | 需求/验收/合同变更 | `$ws-req-review` |
-| 评审/审计/找风险 | `$ws-review` |
+| 评审/审计/风险 | `$ws-review` |
 | finish/merge/push/cleanup | `$ws-finish` |
 | handoff/archive | `$ws-handoff` |
-| 先出设计方案 | `$ws-plan`（设计作为 plan 阶段一部分） |
-| 更新规范/验收标准 | `$ws-req-change`（需求变更需先 review） |
-| 中大型实现 | `$ws-plan` |
+| 先出设计方案 | `$ws-plan`（已走 goal → `$ws-goal` 管道） |
+| 更新规范/验收 | `$ws-req-change`（先 review） |
+| 中大型实现（goal 可用） | `$ws-goal`（`goal_driven`） |
+| 中大型实现（goal 不可用） | `$ws-plan`（`plan_first`） |
 | 小步明确实现/修复 | `$ws-dev` |
-| 极简修复 | `$ws-dev-lite` |
-| Subagent 不可用 | 回退单 agent + 工件模式 |
-
-注：`$ws-dev` 默认走 subagent-first 策略。主 session 应优先通过 `$ws-delegate` 派发 `aiws-worker`，除非用户明确说"直接改"。
+| 极简修复 / 显式跳过流程 | `$ws-dev-lite`（后者 `escape_hatch`） |
+| Subagent 不可用 | 单 agent + 工件模式 |
 
-**Escape Hatch**：用户明确说"跳过流程"时允许 direct_implementation，但须输出 `[escape-hatch]` 标记、归因到 Req_ID、有可复现验证入口、落盘 evidence 注明原因。
+注：`$ws-dev` 默认 subagent-first；主 session 优先 `$ws-delegate` → `aiws-worker`，除非用户说「直接改」。
 
+**Escape Hatch**：用户明确「跳过流程」/「直接改」/「do it inline」→ `$ws-dev-lite`，须 `[escape-hatch]`、Req_ID、可复现验证、evidence 注明原因。小修入口保留，不得全灌 `$ws-goal`。
 ### 3. 意图不明确
 
 只问 1-3 个关键问题（意图、Req_ID/Problem_ID、verify、change），然后停止。
 
 ### 4. Continuation Routing（新 session 恢复）
 
-续跑决策：
-
-| Phase | Next Action |
-|-------|-------------|
-| none（无 change） | ws-intake 或 ws-plan |
-| intake | ws-intake 继续，或 ws-plan |
-| planning | plan 存在→ws-plan-verify；否则 ws-plan |
-| ready-for-dev | 派发 aiws-worker |
-| in-progress | patches 存在→review；was DONE_WITH_CONCERNS→ws-quality-review；否则继续 |
-| review | evidence 齐→ws-finish/ws-commit；否则补 evidence |
-| finished | ws-finish 收尾归档 |
-| unknown | ws-preflight |
+change 相位 + goal 叠加；goal 优先于冷启动 plan/dev 跳过：
 
-Subagent 降级：无 subagent 时当前 agent 直接执行，evidence 中记录降级原因（`mode: single-agent`）。
+| Phase / Goal | Next |
+|--------------|------|
+| active goal | `$ws-goal` resume（按 state next_action） |
+| paused goal | `$ws-goal` resume（继续 / 改目标 / 放弃后冷启动） |
+| none | intake；或 medium+ 且 goal 可用 → `$ws-goal`；否则 `$ws-plan` |
+| intake | 继续 intake，或 plan/goal（按可用性与冻结） |
+| planning | 有 plan→plan-verify；否则 plan（goal 内则 `$ws-goal`） |
+| ready-for-dev | 派发 aiws-worker（goal 绑定经 `$ws-goal`） |
+| in-progress | 有 patches→review；DONE_WITH_CONCERNS→quality-review；否则继续 |
+| review | evidence 齐→finish/commit；否则补 evidence |
+| finished / unknown | `$ws-finish` 归档 / `$ws-preflight` |
 
-特殊状态：`BLOCKED` 需解 blocker；`NEEDS_CONTEXT` 补 JSONL 后重试。
+Subagent 降级：无 subagent 时本 agent 执行，evidence 记 `mode: single-agent`。`BLOCKED` 解 blocker；`NEEDS_CONTEXT` 补 JSONL 后重试。
 
 ### 5. 输出路由
 
 ```
-Root: <path>
-Found: <files>
-OpenCode mode: <oMo-enabled / standard-opencode>
-Task intent: <分类>
-Binding: <清晰 / 缺失项>
-Route: <$ws-... 或 clarify>
-Why: <一句到三句>
-Next: <继续执行对应 skill，或提出澄清问题>
+Root: / Found: / OpenCode mode: / Task intent: / Binding: / Route: / Why: / Next:
 ```
 
 ## 约束
 
-- Router 自己不实现代码；不给 route 前不直接改代码
-- 一次只选一个主 route
-- 复杂度升高：`$ws-dev` 回退 `$ws-plan`；`$ws-finish` 回退前置门禁
-- subagent 不可用：单 agent 执行，但须维护等价工件结构
+- Router 不实现；不给 route 前不改代码；一次一个主 route；复杂度升高时 `$ws-dev` → `$ws-plan`/`$ws-goal`，`$ws-finish` 回退前置门禁
+- subagent 不可用：单 agent，维护等价工件；不用 L4 程序化 skill invoke（agent 读规则后进入 skill）
 
 > 运行时行为约束：`packages/spec/docs/run-behavior-guidelines.md`

package/templates/workspace/.opencode/skills/ws-delegate/SKILL.md

@@ -5,67 +5,46 @@ description: 使用时机：需要拆分子任务、委托给子 agent 时。触
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：优先借用 oMo agent 做任务拆分；若不可用，回退普通 OpenCode delegation / 单 agent。
+目标：优先 oMo agent 拆分任务；不可用则回退 OpenCode delegation / 单 agent。
 
 ## 核心约束
 
-- **Subagent-First**：主 session 只做编排收敛，不直接写代码。所有产出由 subagent 完成并可追溯。
-- **Handoff 证据**：worker 必须产出 `.aiws/changes/<id>/handoff-evidence.md`（完成项、未完成项、残余风险）。文件缺失=委托未完成。
+- **Subagent-First**：主 session 只编排收敛，不写代码；产出由 subagent 完成并可追溯。
+- **Handoff 证据**：worker 必须产出 `.aiws/changes/<id>/handoff-evidence.md`（完成/未完成/残余风险）。缺失=委托未完成。
 
-## 必需输入
+## 必需输入 / 输出
 
-- 真值文件 + delegation contract 等上下文（`workflow-delegation-contracts.md`、`opencode-omo-adapter.md`、`opencode-subagent-first.md`）
-- 当前任务已绑定 `Req_ID` / change / Verify
+**输入：** 真值 + delegation contract 上下文（`workflow-delegation-contracts.md`、`opencode-omo-adapter.md`、`opencode-subagent-first.md`）；任务已绑定 `Req_ID` / change / Verify。
 
-## 必需输出
+**输出：** `Delegation Plan:` role / preferred agent / readScope / writeScope / artifactTargets / fallback；`Context Curation:` / `Execution Mode:` / `Evidence:` / `Next:`。
 
-- `Delegation Plan:` role / preferred agent / readScope / writeScope / artifactTargets / fallback
-- `Context Curation:` 策展详情 / `Execution Mode:` / `Evidence:` / `Next:`
+**执行：** 主 session 不改代码；产物由 subagent 可追溯产出；handoff 含 delegate round number、产出路径、未关闭项。
 
-## 执行要求
-
-- 主 session 不直接改代码；所有产物由 subagent 产出且可追溯
-- handoff 含 delegate round number、产出文件路径、已知未关闭项
-
-## 阻断条件
-
-任务未绑定 / 委托边界不清 / 上下文策展未执行 / 无法判断 oMo 可用性 / handoff 文件缺失
+**阻断：** 任务未绑定 / 边界不清 / 未策展上下文 / 无法判断 oMo 可用性 / handoff 缺失。
 
 ## 角色映射
 
-| aiws 角色 | oMo Agent |
-|-----------|-----------|
-| planner | planner-sisyphus |
-| explorer | @explore / @librarian |
-| reviewer | @oracle |
-| integrator | 当前主 agent |
-
-推荐标准角色：
-
-| 角色 | 职责 | 读取 | 写入 |
-|------|------|------|------|
-| implementer | 代码+测试实现 | 真值+change上下文 | 代码+测试+evidence/ |
-| reviewer | 独立审查 | 真值+diff+evidence | review/*.md |
-| researcher | 分析探索 | 真值+外部文档 | analysis/*.md |
+| aiws | oMo | 标准角色 | 职责 | 读 | 写 |
+|------|-----|----------|------|----|----|
+| planner | planner-sisyphus | implementer | 代码+测试 | 真值+change | 代码+测试+evidence/ |
+| explorer | @explore / @librarian | reviewer | 独立审查 | 真值+diff+evidence | review/*.md |
+| reviewer | @oracle | researcher | 分析探索 | 真值+外部文档 | analysis/*.md |
+| integrator | 当前主 agent | | | | |
 
 ## 连续执行循环
 
-1. 主 session 策展上下文 JSONL → dispatch `aiws-worker`
-2. 检查返回状态（DONE / DONE_WITH_CONCERNS / NEEDS_CONTEXT / BLOCKED）
-3. DONE → dispatch `aiws-reviewer`；pass→收敛 evidence；fail→worker 修复（≤3 次）
+1. 主 session 策展 JSONL → dispatch `aiws-worker`
+2. 检查 Status：DONE / DONE_WITH_CONCERNS / NEEDS_CONTEXT / BLOCKED
+3. DONE → dispatch `aiws-reviewer`；pass→收敛 evidence；fail→worker 修复（≤3）
 4. DONE_WITH_CONCERNS → 先 `ws-quality-review`
-5. NEEDS_CONTEXT → 补上下文重试（≤2 次）；仍失败→回退单 agent
-6. BLOCKED → 输出 blocker 详情，不继续
+5. NEEDS_CONTEXT → 补上下文重试（≤2）；仍失败→回退单 agent
+6. BLOCKED → 输出 blocker，不继续
 
 ## 上下文策展
 
-1. 读取合同基线的 `contextFiles`
-2. 展开 glob（替换 `<id>`）
-3. 委托者调整（添加/删除/调整 priority/sections）
-4. 预算检查：high+medium ≤5 文件，总行数 ≤4000
-5. 写入 `.aiws/changes/<id>/analysis/<role>-context.jsonl`
+1. 读合同 `contextFiles` → 2. 展开 glob（`<id>`）→ 3. 委托者调整（增删/priority/sections）→ 4. 预算 high+medium ≤5 文件、总行 ≤4000 → 5. 写 `.aiws/changes/<id>/analysis/<role>-context.jsonl`
 
-插件 `aiws-inject-context` 自动注入 JSONL——在 `task()` 中指定 `role: <role>` 即可。
+插件 `aiws-inject-context` 自动注入；`task()` 指定 `role: <role>` 即可。
 
 ## 子 agent 返回协议
 
@@ -91,13 +70,10 @@ Context Curation: .aiws/changes/<id>/analysis/worker-context.jsonl
 
 ## 委托者检查清单
 
-派遣前：`[ ] prompt 含上下文引用` `[ ] JSONL 已写入` `[ ] 预算检查通过` `[ ] readScope/writeScope/artifactTargets 已声明`
+**派遣前：** `[ ] prompt 含上下文引用` `[ ] JSONL 已写` `[ ] 预算通过` `[ ] readScope/writeScope/artifactTargets 已声明`
 
-返回后：`[ ] 解析 Status` `[ ] 非 DONE→按规则处理` `[ ] 非 DONE→记录决策到 delegation-decisions.md` `[ ] handoff 文件存在且非空`
+**返回后：** `[ ] 解析 Status` `[ ] 非 DONE→按规则处理` `[ ] 非 DONE→记入 delegation-decisions.md` `[ ] handoff 存在且非空`
 
-安全：
-- 不让 `ws-delegate` 变成第二套 orchestrator
-- 不让 delegated agent 越权写未授权文件
-- 不跳过 submodule drift check（若 `.gitmodules` 存在）
+**安全：** 不把 `ws-delegate` 做成第二套 orchestrator；delegated agent 不越权写未授权文件；有 `.gitmodules` 时不跳过 submodule drift check。
 
 > 运行时行为约束：`packages/spec/docs/run-behavior-guidelines.md`

package/templates/workspace/.opencode/skills/ws-dev/SKILL.md

@@ -5,23 +5,18 @@ description: 使用时机：需要修改代码、配置、测试时。触发词
 
 用中文输出（命令/路径/代码标识符保持原样不翻译）。
 
-目标：在 AIWS 约束下完成一个可回放、可验证的小步交付。
-
-阶段定位：implementation 阶段。
+目标：在 AIWS 约束下完成可回放、可验证的小步交付。阶段：implementation。
 
 ## 必需输入
 
-- 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
-- 当前任务的归因目标（`Req_ID` 或 `Problem_ID`）
-- 若为 medium/complex：已通过 `$ws-plan` / `$ws-plan-verify` 的计划
-- 当前 `change/<change-id>` 上下文或等价变更归因
+- 真值：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
+- 归因：`Req_ID` 或 `Problem_ID`；`change/<change-id>` 上下文
+- medium/complex：已通过 `$ws-plan` / `$ws-plan-verify` 的计划
 
 ## 必需输出
 
-- `变更文件（Changed）:` 实际改动清单
-- `验证（Verify）:` 实际运行的命令与结果
-- `证据（Evidence）:` `plan/...`、`.aiws/changes/<change-id>/...` 等证据路径
-- `Next:` 若准备提交，建议 `$ws-review` 或 `$ws-commit`
+- `变更文件（Changed）:` / `验证（Verify）:` / `证据（Evidence）:` 路径
+- `Next:` 准备提交时建议 `$ws-review` 或 `$ws-commit`
 
 ## 前置条件（硬阻断 — 必须最先检查）
 
@@ -33,58 +28,46 @@ description: 使用时机：需要修改代码、配置、测试时。触发词
 
 ## TDD 约束（强制）
 
-对于编写新代码或修改业务逻辑的任务，必须遵守 RED-GREEN-REFACTOR：
-1. **RED**：先写测试，运行并确认测试失败
-2. **GREEN**：最小实现使测试通过
-3. **REFACTOR**：重构，保持测试通过
-禁止：先写实现再补测试 / 跳过测试直接提交。
-修改后自检：`lint → typecheck → test`（项目无对应脚本则跳过）。
+新代码/业务逻辑改动必须 RED-GREEN-REFACTOR：
+1. **RED**：先写测试并确认失败 → 2. **GREEN**：最小实现通过 → 3. **REFACTOR**：保持绿
+禁止先实现后补测 / 跳过测试提交。改后自检：`lint → typecheck → test`（无脚本则跳过）。
 
 ## 完成判定
 
-改动已落盘、验证已执行或已说明未执行原因、证据路径可回放，可进入 review/commit。
+改动已落盘、验证已执行或已说明未执行原因、证据可回放 → 可进 review/commit。
 
 ## 建议流程
 
 ### 1. Preflight
 
-定位项目根，读取真值文件，输出约束摘要。
-- 中大型任务：先用 `$ws-plan` 生成 `plan/` 工件，并默认执行 3.1 自我修正循环
-- 已有计划：先 `$ws-plan-verify`，通过后进入实现
-- `$ws-plan` 已创建 worktree：直接在其中继续
+定位项目根，读真值，输出约束摘要。中大型先 `$ws-plan`（默认走 3.1）；已有计划先 `$ws-plan-verify`；已有 worktree 则直接继续。
 
 ### 1.5 Spec Refresh（进入实现前必做）
 
-重读 `AI_PROJECT.md` 安全边界和 `REQUIREMENTS.md` 相关条目，输出 2-3 段摘要。避免遗忘约束或需求边界。
+重读 `AI_PROJECT.md` 安全边界与 `REQUIREMENTS.md` 相关条目，输出 2-3 段摘要。
 
 ### 2. 建立变更归因
 
-- `git status --porcelain` 仅有计划/工件文件 → 继续
-- 创建新 change：`aiws change start <change-id> --hooks --no-switch`
-- 切换分支：先确认无未提交改动，再 `git switch change/<change-id>`
-- 有 submodule：准备好 `submodules.targets`（`aiws change start` 自动检测 `.gitmodules`）
+- `git status --porcelain` 仅有计划/工件 → 继续
+- 新建：`aiws change start <change-id> --hooks --no-switch`；切换前确认无未提交改动再 `git switch change/<change-id>`
+- submodule：准备 `submodules.targets`（`aiws change start` 自动检测 `.gitmodules`）
 
 ### 3. 实现策略：默认 dispatch aiws-worker（Subagent-First）
 
 详见 `packages/spec/docs/opencode-subagent-first.md`。
-- 主 session **默认不直接写代码**；通过 `$ws-delegate` 派发 `aiws-worker`（`task()` 中加 `role: worker`）
-- worker 返回后派发 `aiws-reviewer` 独立审查，根据结果 fix 或收敛 evidence
-- **Inline escape hatch**：用户说"直接改"或"do it inline"时可直接写代码，但必须落盘记录理由
-- 验证先行：先确认 `AI_WORKSPACE.md` 中验证命令；不明确则先补验证入口再实现
+- 主 session **默认不直接写代码**；`$ws-delegate` 派发 `aiws-worker`（`task()` 加 `role: worker`）
+- worker 返回后派发 `aiws-reviewer` 独立审查，再 fix 或收敛 evidence
+- **Inline escape hatch**：用户说"直接改"/`do it inline` 时可直写，须落盘记录理由
+- 验证先行：确认 `AI_WORKSPACE.md` 验证命令；不明确则先补入口再实现
 
 ### 3.1 自我修正循环（evaluate-optimize）——必经步骤
 
-dispatch 前最多 **2 轮** 自审+修正：subagent 产出 → 主 session 检查（lint/typecheck/代码模式）→ 有问题则要求修正 → 2 轮后仍有问题升级到 `$ws-review`。
-适用：所有非 trivial 改动。注意：不替代 `$ws-review` 正式 gate。
+dispatch 前最多 **2 轮**：产出 → 主 session 检查（lint/typecheck/模式）→ 有问题则修正；2 轮后仍有问题升级 `$ws-review`。适用非 trivial；不替代 `$ws-review` 正式 gate。
 
 ### 4. 其他规则
 
-- 需求调整：`$ws-req-review` → 确认后 `$ws-req-change`
-- 最小改动：每处改动归因到 `REQUIREMENTS.md` 或 `issues/problem-issues.csv`
-- 验证：运行 `AI_WORKSPACE.md` 命令；未运行不声称已运行
-- 多步任务用 `update_plan` 跟踪
-- 提交前门禁：`aiws validate .`
-- 交付收尾：`$ws-finish`
+- 需求调整：`$ws-req-review` → `$ws-req-change`；最小改动归因到 `REQUIREMENTS.md` 或 `issues/problem-issues.csv`
+- 验证跑 `AI_WORKSPACE.md` 命令（未运行不声称已运行）；多步用 `update_plan`；提交前 `aiws validate .`；收尾 `$ws-finish`
 
 ## 输出要求
 

package/templates/workspace/.opencode/skills/ws-frontend-design/SKILL.md

@@ -23,34 +23,21 @@ description: 使用时机：需要前端设计、UI/UX 实现时。触发词：
 - `Interaction thesis:` 2-3 个动效想法及其如何改善层级/氛围/可感知性
 
 ## 设计默认值
-- 从构图开始，不从组件库开始
-- 第一屏优先海报感（poster），不是文档感（document）
-- 默认先找强视觉锚点：大图、主视觉平面、关键产品画面、主数据工作区
-- 默认不做卡片墙；优先 section / column / divider / media block / list / plain layout
-- 默认最多两套字体、一种强调色；已有品牌系统则优先跟随
-- 优先靠留白、尺度、裁切、对比、对齐建立层级，再考虑装饰
+- 构图优先于组件库；第一屏偏海报感，非文档感
+- 强视觉锚点：大图 / 主视觉平面 / 产品画面 / 主数据工作区
+- 避免卡片墙；用 section / column / divider / media / list / plain layout
+- ≤两套字体、一种强调色（有品牌系统则跟随）；靠留白、尺度、裁切、对比、对齐建层级
 
 ## Landing 规则
-默认结构：
-- Hero：品牌/产品名、承诺、CTA、一个主视觉
-- Support：一个具体能力 / 证明点
-- Detail：氛围、流程、产品深度或故事
-- Final CTA：开始、注册、联系、访问
-Hero 强约束：
-- 一个 section 只承载一个 dominant idea
-- 默认 full-bleed hero；仅内层文字列约束宽度
-- 品牌名 > headline > body > CTA
-- 不要 hero cards / stat strips / logo clouds / pill soup / floating dashboards
-- headline desktop 约 2-3 行；mobile 一眼读完
-- 有固定 header 时占用首屏预算；header + hero 不超出 viewport
-- 若去掉主视觉后首屏仍几乎成立，说明图像太弱
+结构：Hero（名/承诺/CTA/主视觉）→ Support（能力/证明）→ Detail（氛围/流程/故事）→ Final CTA
+Hero：每 section 一个 dominant idea；默认 full-bleed（仅文字区限宽）；品牌名 > headline > body > CTA
+禁止：hero cards / stat strips / logo clouds / pill soup / floating dashboards
+headline desktop 约 2-3 行、mobile 一眼读完；header+hero 不超 viewport；主视觉去掉后首屏仍成立=图像太弱
 
 ## App-UI 规则
-- 偏克制：少颜色、少 chrome、清晰栅格、密度适中、信息可扫读
-- 优先组织为 primary workspace → navigation → secondary context → action
-- card 只用作交互容器；否则改回 plain layout
-- 不要把常规产品 UI 做成营销落地页
-- 文案优先 orientation / status / action；不要首页口号 / 情绪隐喻 / 执行摘要横幅
+- 克制：少色、少 chrome、清晰栅格、可扫读；primary workspace → nav → secondary context → action
+- card 仅作交互容器，否则 plain layout；勿把产品 UI 做成营销页
+- 文案偏 orientation / status / action；忌口号 / 情绪隐喻 / 摘要横幅
 
 ## 图像与媒体
 - 图像必须承担叙事任务，不能只是补背景
@@ -78,14 +65,9 @@ Hero 强约束：
 - 图像上的文字必须保证对比度与点击区域可用
 - 必须同时考虑 desktop / mobile；验证命令优先引用 `AI_WORKSPACE.md`
 
-## 硬规则
-默认不堆卡片 / hero cards / SaaS card grid。每 section 一个 dominant idea。最多两套字体、一种强调色。产品 UI 后不加装饰渐变，图像后不堆文字，不用 filler copy。
-
-## 实现检查（交付前自检）
-- 第一屏能否一眼看出品牌/产品；是否有明确视觉锚点
-- 只扫标题能否理解页面；每个 section 是否只有一个职责
-- card 是否真有必要；动效是否真正提升层级/氛围
-- 去掉装饰阴影后页面是否仍成立
+## 实现检查（交付前）
+- 首屏品牌/锚点明确；扫标题即可懂页；每 section 单一职责
+- card 有必要；动效真提升层级；去装饰阴影后页面仍成立
 
 ## 输出要求
 - `Mode:` `landing | app-ui | polish-only`