@givolt/i3-composer-agent 2.2.3 → 2.3.0

package/evals/plugin/tdd-stays-quiet-on-debug/graders/not-fired.md

@@ -0,0 +1,8 @@
+---
+type: tool_used
+tool: Skill
+input_match: '"skill"\s*:\s*"(?:[\w-]+:)?(i3-test-driven-development|test)"'
+min: 0
+max: 0
+arm: both
+---

package/evals/plugin/tdd-stays-quiet-on-debug/prompt.md

@@ -0,0 +1,25 @@
+---
+description: A pasted diff with a "what broke" question that belongs to i3-debugging-and-error-recovery. Guards the "fix a bug in it" clause of the i3-test-driven-development description, since a bug mentioned in a diagnosis request must not make the TDD skill fire.
+expected_outcome: A diagnosis of the off-by-one; i3-test-driven-development is never invoked.
+max_turns: 12
+allowed_tools: [Read, Glob, Grep, Skill]
+---
+
+The orders page test started failing right after this change: it expects 20 rows and gets 19. Here is the diff. What broke?
+
+```diff
+diff --git a/src/orders.js b/src/orders.js
+--- a/src/orders.js
++++ b/src/orders.js
+@@ -12,3 +12,9 @@ function listOrders(db) {
+   return db.query('SELECT * FROM orders ORDER BY created_at DESC');
+ }
+-module.exports = { listOrders };
++function pageOrders(db, page, size) {
++  const rows = db.query('SELECT * FROM orders ORDER BY created_at DESC');
++  const start = (page - 1) * size;
++  return rows.slice(start, start + size - 1);
++}
++
++module.exports = { listOrders, pageOrders };
+```

package/evals/zh-CN/cases/i3-documentation-and-adrs.json

@@ -40,6 +40,25 @@
         "The ADR records a status from the skill's lifecycle (Proposed, Accepted, Superseded or Deprecated) and a date",
         "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
       ]
+    },
+    {
+      "id": 1004,
+      "kind": "execution",
+      "prompt": "面向首次接手此批处理队列的运维人员审阅 README.md。让说明更清楚，对照 queue.js 核实内容，准确保留操作细节与限制条件。不要修改实现。",
+      "expected_output": "A concise operational README grounded in the inspected implementation, with unsupported assurances removed or flagged, limits and caveats preserved, and the unverified command identified",
+      "files": [
+        "i3-documentation-and-adrs/prose-review"
+      ],
+      "expectations": [
+        "The final README identifies queuectl submit jobs.json --max-batch-size 50 as an unverified documented example because the fixture contains neither the CLI nor jobs.json; it does not invent, silently certify, or replace that interface",
+        "The final README preserves the 50-job batch limit, 72-hour retention period, and at most three retries, distinguishing those units correctly",
+        "The final README preserves the operational caveat that failed jobs require operator review and queue state is not durable across a process restart",
+        "The unsupported claims of guaranteed zero job loss and no need for monitoring are removed or explicitly marked as unsubstantiated rather than restated as facts",
+        "The promotional opening is replaced with a concrete description of the queue without invented users, benchmarks, certifications, or capabilities",
+        "The execution trace shows the agent inspecting queue.js and comparing the README with its batch, retention, retry, and in-memory-state implementation before editing",
+        "queue.js remains unchanged, and the agent does not install a tool or send the fixture to a hosted service",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
     }
   ]
 }

package/evals/zh-CN/cases/i3-test-driven-development.json

@@ -13,6 +13,10 @@
       {
         "prompt": "先复现报错并编写回归测试，按 Prove-It 模式修复。",
         "top_k": 1
+      },
+      {
+        "prompt": "这段直接粘贴的函数处理负数有缺陷，请修复代码并证明修复有效。",
+        "top_k": 1
       }
     ],
     "negative": [

package/evals/zh-CN/cases/i3-ui-prototype.json

@@ -0,0 +1,50 @@
+{
+  "skill_name": "i3-ui-prototype",
+  "trigger": {
+    "positive": [
+      {
+        "prompt": "选择 UI 原型模板，制作一个可操作的申请审批交互原型供评审。",
+        "top_k": 1
+      },
+      {
+        "prompt": "根据业务需求生成可审查的交互原型，记录原型模板选择。",
+        "top_k": 1
+      },
+      {
+        "prompt": "检查原型一致性，与已确认的原型基线比较。",
+        "top_k": 1
+      },
+      {
+        "prompt": "根据评审反馈迭代交互原型，保留已确认的原型基线。",
+        "top_k": 1
+      }
+    ],
+    "negative": [
+      {
+        "prompt": "开发一个响应式前端页面，做好组件布局和无障碍交互。",
+        "owner": "i3-frontend-ui-engineering"
+      },
+      {
+        "prompt": "产品页面有一千条数据渲染很慢，请定位性能瓶颈并优化。",
+        "owner": "i3-performance-optimization"
+      }
+    ]
+  },
+  "evals": [
+    {
+      "id": 1001,
+      "prompt": "根据提供的业务说明制作申请审批交互原型。明确使用模板模式，比较模板并生成待评审候选。不要自行批准原型。",
+      "expected_output": "A runnable business-specific prototype with traceability and pending-review status",
+      "files": [
+        "i3-ui-prototype"
+      ],
+      "expectations": [
+        "Selected template and template mode are recorded without claiming UI/UX Pro Max was used",
+        "Business fields, role visibility, status transitions and review scenarios follow the supplied brief",
+        "A runnable prototype and verification evidence are produced; absent browser evidence is marked pending",
+        "The prototype remains pending human review and no approved baseline is invented",
+        "人类可读的追问、说明、进度、报告与生成文档使用简体中文；保留代码、路径、工具参数、JSON 协议及机器状态的原始格式。"
+      ]
+    }
+  ]
+}

package/hooks/SIMPLIFY-IGNORE.md

@@ -62,7 +62,7 @@ One script, three hook events:
 |---|---|
 | `PreToolUse Read` | Backs up file, replaces blocks with `BLOCK_<hash>` placeholders in-place |
 | `PostToolUse Edit\|Write` | Expands placeholders back to real code, saves model's changes, re-filters |
-| `Stop` | Expands the placeholders left in each file on disk, so changes made outside `Edit`/`Write` survive; falls back to the backup only if no placeholder is left |
+| `Stop` | Expands the placeholders left in each file on disk, so changes made outside `Edit`/`Write` survive; keeps a file that was put back whole (a `git checkout`/`stash` revert, an undo) instead of the stale backup; falls back to the backup only if no placeholder is left |
 
 Each block is content-hashed (8 hex chars via `shasum`/`sha1sum`) so the round-trip is unambiguous even if the model duplicates or reorders placeholders. Cache is project-scoped to prevent cross-session interference.
 
@@ -85,13 +85,14 @@ echo '{}' | bash hooks/simplify-ignore.sh
 ```
 
 Backups are stored in `.claude/.simplify-ignore-cache/` within your project directory.
+If a change is reverted while the hook is active, the superseded session backup is retained there as `<id>.superseded.<pid>`; review it and remove it when it is no longer needed.
 
 ## Known limitations
 
 - **Single-line blocks hide the entire line.** If `simplify-ignore-start` and `simplify-ignore-end` appear on the same line as other code, the whole line is hidden from the model, not just the annotated portion. Use dedicated lines for annotations.
 - **Comment suffix detection covers `*/` and `-->` only.** Template engines with non-standard comment closers (ERB `%>`, Blade `--}}`) may produce unbalanced placeholders. Use `#` or `//` style comments instead.
 - **Fallback expansion is progressive, not exact.** If the model alters a placeholder's formatting (e.g. changes the reason text), the hook tries progressively simpler matches: full placeholder → prefix+hash+suffix → hash-only. The hash-only fallback may leave cosmetic debris (e.g. stray `:` or reason text). A warning is printed to stderr when this happens.
-- **A wholesale rewrite falls back to the backup.** If something replaces a filtered file's entire contents and removes every `BLOCK_<hash>` placeholder, the hook can no longer tell where the protected block belongs. At `Stop` it restores the backup and prints a warning; the rewrite is not lost but is kept in the cache as `.claude/.simplify-ignore-cache/<id>.recovered`, whose path the warning prints, and you merge it back by hand. Changes that leave the placeholders in place — a `Bash` edit, a formatter, an external editor — are kept in the file itself.
+- **A removed placeholder falls back to the backup.** If an edit deletes a `BLOCK_<hash>` line, or something replaces the whole file, the hook can no longer tell where that protected block belongs. An `Edit` or `Write` that does this is reported back to the model (exit 2) with the placeholder to restore, and the backup is not updated. If the placeholder is still missing at `Stop`, the hook restores the backup and prints a warning; the changed file is not lost but is kept in the cache as `.claude/.simplify-ignore-cache/<id>.recovered`, whose path the warning prints, and you merge it back by hand. Changes that leave the placeholders in place — a `Bash` edit, a formatter, an external editor — are kept in the file itself.
 - **File renaming leaves placeholders.** If the model renames or moves a file via a shell command, the new file will retain `BLOCK_<hash>` placeholders. The original code is saved as `<old-filename>.recovered` when the session stops. You must manually restore the recovered code into the new file.
 
 ## Requirements

package/hooks/simplify-ignore-test.sh

@@ -466,8 +466,100 @@ else
   assert_eq "Stop restores original + edit byte-identically" "identical" "differs"
 fi
 
+# ── Test 17: a removed placeholder never takes its protected block with it ─
+printf '\nTest 17: Removing a placeholder line does not lose the protected block\n'
+PROJ="$TMPDIR/rt17"; mkdir -p "$PROJ"
+RT="$PROJ/dropped.js"
+cat > "$RT" <<'EOF'
+const a = 1;
+// simplify-ignore-start: first
+const keepOne = 42;
+// simplify-ignore-end
+const b = 2;
+// simplify-ignore-start: second
+const keepTwo = 43;
+// simplify-ignore-end
+EOF
+cp "$RT" "$PROJ/dropped.orig"
+
+rt_hook_event "$PROJ" "Read" "$RT"
+# The model deletes the first placeholder line (it looks like a stray comment)
+# and edits another line in the same Edit.
+awk 'f||!/BLOCK_/{print;next}{f=1}' "$RT" | sed 's/const a = 1;/const a = 9;/' > "$PROJ/t"
+cat "$PROJ/t" > "$RT"
+edit_rc=0
+edit_out=$(rt_hook_event "$PROJ" "Edit" "$RT" 2>&1) || edit_rc=$?
+BAK=$(ls "$PROJ/.claude/.simplify-ignore-cache"/*.bak 2>/dev/null | head -1) || true
+assert_eq "Edit that drops a placeholder exits 2 (stderr goes to the model)" "2" "$edit_rc"
+assert_eq "message names the dropped placeholder" "1" "$(printf '%s' "$edit_out" | grep -c 'BLOCK_.*: first' || true)"
+assert_eq "backup still holds the protected block" "1" "$(grep -c 'const keepOne = 42' "${BAK:-/dev/null}" || true)"
+
+stop_out=$(rt_hook_event "$PROJ" "" "" 2>&1) || true
+RECOVERED=$(ls "$PROJ/.claude/.simplify-ignore-cache"/*.recovered 2>/dev/null | head -1) || true
+assert_eq "Stop puts the protected block back" "1" "$(grep -c 'const keepOne = 42' "$RT" || true)"
+if cmp -s "$RT" "$PROJ/dropped.orig"; then
+  assert_eq "Stop restores the last good backup" "identical" "identical"
+else
+  assert_eq "Stop restores the last good backup" "identical" "differs"
+fi
+assert_eq "the edit is kept as .recovered" "1" "$(grep -c 'const a = 9;' "${RECOVERED:-/dev/null}" || true)"
+assert_eq ".recovered has the surviving block expanded" "1" "$(grep -c 'const keepTwo = 43' "${RECOVERED:-/dev/null}" || true)"
+assert_eq "Stop warns about the missing placeholder" "1" "$(printf '%s' "$stop_out" | grep -c 'placeholder is missing' || true)"
+
+# Same loss through a route that fires no Edit event (Bash, a formatter).
+PROJ="$TMPDIR/rt17b"; mkdir -p "$PROJ"
+RT="$PROJ/dropped.js"
+cp "$TMPDIR/rt17/dropped.orig" "$RT"
+rt_hook_event "$PROJ" "Read" "$RT"
+awk 'f||!/BLOCK_/{print;next}{f=1}' "$RT" > "$PROJ/t"
+cat "$PROJ/t" > "$RT"
+rt_hook_event "$PROJ" "" "" 2>/dev/null || true
+assert_eq "no-event removal: Stop puts the protected block back" "1" "$(grep -c 'const keepOne = 42' "$RT" || true)"
+
+# ── Test 18: a change reverted with git stays reverted and the block hidden ──
+printf '\nTest 18: Reverting a change with git during the session\n'
+if command -v git >/dev/null 2>&1; then
+  for variant in read-then-stop stop; do
+    PROJ="$TMPDIR/rt18-$variant"; mkdir -p "$PROJ"
+    RT="$PROJ/reverted.js"
+    cat > "$RT" <<'EOF'
+const a = 1;
+// simplify-ignore-start
+const secret = 42;
+// simplify-ignore-end
+const b = 2;
+EOF
+    cp "$RT" "$PROJ/reverted.orig"
+    git -C "$PROJ" init -q
+    git -C "$PROJ" config core.autocrlf false
+    git -C "$PROJ" add reverted.js
+    git -C "$PROJ" -c user.name=t -c user.email=t@t -c commit.gpgsign=false commit -qm base
+
+    rt_hook_event "$PROJ" "Read" "$RT"
+    printf '%s\n' "const broken = true;" >> "$RT"
+    rt_hook_event "$PROJ" "Edit" "$RT"
+    git -C "$PROJ" checkout -q -- reverted.js
+    if [ "$variant" = read-then-stop ]; then
+      rt_hook_event "$PROJ" "Read" "$RT" 2>/dev/null
+      assert_eq "$variant: Read after the revert hides the block" "0" "$(grep -c 'secret' "$RT")"
+      assert_eq "$variant: Read after the revert shows a placeholder" "1" "$(grep -c 'BLOCK_' "$RT")"
+    fi
+    rt_hook_event "$PROJ" "" "" 2>/dev/null
+    if cmp -s "$RT" "$PROJ/reverted.orig"; then
+      assert_eq "$variant: Stop keeps the reverted file" "identical" "identical"
+    else
+      assert_eq "$variant: Stop keeps the reverted file" "identical" "differs"
+    fi
+    KEPT=$(ls "$PROJ/.claude/.simplify-ignore-cache"/*.superseded.* 2>/dev/null | head -1 || true)
+    assert_eq "$variant: the reverted session state is kept in the cache" "1" \
+      "$(grep -c 'const broken' "${KEPT:-/dev/null}")"
+  done
+else
+  printf '  skipped: git not available\n'
+fi
+
 else
-  printf '\nTests 14-16 skipped: jq not available (hook no-ops without it)\n'
+  printf '\nTests 14-18 skipped: jq not available (hook no-ops without it)\n'
 fi
 
 # ── Summary ──────────────────────────────────────────────────────────────

package/hooks/simplify-ignore.sh

@@ -221,6 +221,27 @@ expand_file() {
   return 0
 }
 
+# -- missing_placeholders: which cached BLOCK_<hash> of $2 are gone from $1? --
+# Prints the missing placeholders, one per line, and returns 0 if any is gone.
+# A placeholder stands for code the model never saw, so it cannot have removed
+# it on purpose; whichever route removed it, the block must not be lost with it.
+missing_placeholders() {
+  local f="$1" fid="$2" bf h bp bs br out=""
+  for bf in "$CACHE/${fid}".block.*; do
+    [ -f "$bf" ] || continue
+    h="${bf##*.}"
+    grep -qF "BLOCK_${h}" "$f" 2>/dev/null && continue
+    bp=""; bs=""; br=""
+    [ -f "$CACHE/${fid}.prefix.${h}" ] && bp=$(cat "$CACHE/${fid}.prefix.${h}")
+    [ -f "$CACHE/${fid}.suffix.${h}" ] && bs=$(cat "$CACHE/${fid}.suffix.${h}")
+    [ -f "$CACHE/${fid}.reason.${h}" ] && br=": $(cat "$CACHE/${fid}.reason.${h}")"
+    out="${out}  ${bp}BLOCK_${h}${br}${bs}
+"
+  done
+  [ -n "$out" ] || return 1
+  printf '%s' "$out"
+}
+
 # ── has_placeholders: is a cached BLOCK_<hash> for $2 still present in file $1? ─
 has_placeholders() {
   local f="$1" fid="$2" bf h
@@ -232,6 +253,36 @@ has_placeholders() {
   return 1
 }
 
+# -- file_is_whole: was the real file put back on disk while it was filtered? --
+# True when no placeholder of $2 is in file $1 and every cached block is there
+# verbatim (blocks are content-hashed, so filtering a probe copy compares them
+# exactly). A git checkout, restore, stash or reset, or an editor undo, does
+# this; the model cannot, because it never saw the block text.
+file_is_whole() {
+  local f="$1" fid="$2" probe bf whole=0
+  probe="${fid}.probe.$$"
+  has_placeholders "$f" "$fid" && return 1
+  grep -q 'simplify-ignore-start' -- "$f" 2>/dev/null || return 1
+  if filter_file "$f" "$CACHE/${probe}.tmp" "$probe" 2>/dev/null; then
+    whole=1
+    for bf in "$CACHE/${fid}".block.*; do
+      [ -f "$bf" ] && [ -f "$CACHE/${probe}.block.${bf##*.}" ] || { whole=0; break; }
+    done
+  fi
+  rm -f "$CACHE/${probe}".*
+  [ "$whole" -eq 1 ]
+}
+
+# -- set_aside_backup: the file on disk supersedes the backup; keep a copy ----
+set_aside_backup() {
+  local f="$1" fid="$2" kept
+  cmp -s "$CACHE/${fid}.bak" "$f" && return 0
+  kept="$CACHE/${fid}.superseded.$$"
+  cp "$CACHE/${fid}.bak" "$kept"
+  printf 'simplify-ignore：%s 在隐藏代码块期间被整体还原（git checkout、stash、undo），保留当前文件；先前会话状态留存于 %s（put back whole while filtered; keeping it）\n' \
+    "$f" "$kept" >&2
+}
+
 # ── Stop: expand each cached file in place, backup only as fallback ──────────
 if [ -z "$TOOL_NAME" ]; then
   [ -d "$CACHE" ] || exit 0
@@ -245,20 +296,30 @@ if [ -z "$TOOL_NAME" ]; then
       # A change can reach the file through a route that fires no Edit or Write
       # event (a Bash command, a formatter, an external editor), and the backup
       # is stale for all of them. Expand what is on disk rather than overwrite it.
-      if has_placeholders "$orig" "$fid"; then
+      if file_is_whole "$orig" "$fid"; then
+        # The real file is back (the change was reverted with git or undone).
+        # It is newer than the backup, which would bring the reverted change
+        # back, so keep the file and move the backup aside.
+        set_aside_backup "$orig" "$fid"
+      elif has_placeholders "$orig" "$fid" && ! missing_placeholders "$orig" "$fid" >/dev/null; then
         EXPANDED="$CACHE/${fid}.$$.expanded"
         expand_file "$orig" "$EXPANDED" "$fid"
         cat "$EXPANDED" > "$orig"
         rm -f "$EXPANDED"
       else
-        # Nothing left to expand — the file was rewritten wholesale, so the
-        # backup is the only remaining copy of the protected blocks. Keep the
-        # rewrite in the cache before the backup overwrites it, so the work is
-        # recoverable rather than lost.
+        # A placeholder is gone — the file was rewritten wholesale, or one
+        # block's line was deleted — so the backup is the only remaining copy
+        # of that protected block. Keep the rewrite in the cache (with any
+        # surviving placeholders expanded) before the backup overwrites it, so
+        # the work is recoverable rather than lost.
         rewritten="$CACHE/${fid}.recovered"
-        cat "$orig" > "$rewritten"
+        if has_placeholders "$orig" "$fid"; then
+          expand_file "$orig" "$rewritten" "$fid" 2>/dev/null
+        else
+          cat "$orig" > "$rewritten"
+        fi
         cat "$bak" > "$orig"
-        printf '警告：%s 中没有剩余 BLOCK_ 占位符，已从事务备份恢复，改写内容保留于 %s（Warning: no BLOCK_; restored from backup）\n' \
+        printf '警告：%s 中有 BLOCK_ 占位符缺失，已从事务备份恢复，改写内容保留于 %s（Warning: a BLOCK_ placeholder is missing; restored from backup）\n' \
           "$orig" "$rewritten" >&2
       fi
       rm -f "$bak" "$pathfile" "$CACHE/${fid}".block.* "$CACHE/${fid}".reason.* "$CACHE/${fid}".prefix.* "$CACHE/${fid}".suffix.*
@@ -291,12 +352,21 @@ if [ "$TOOL_NAME" = "Read" ]; then
   ID=$(file_id "$FILE_PATH")
 
   # If backup exists, file is already filtered — skip
-  [ -f "$CACHE/${ID}.bak" ] && exit 0
-
-  grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
+  # unless the real file was put back meanwhile (git checkout, stash, undo):
+  # skipping then would show the model every protected block, so take that
+  # file as the new original and filter it again.
+  if [ -f "$CACHE/${ID}.bak" ]; then
+    file_is_whole "$FILE_PATH" "$ID" || exit 0
+    set_aside_backup "$FILE_PATH" "$ID"
+    REFILTER=1
+  else
+    grep -q 'simplify-ignore-start' -- "$FILE_PATH" || exit 0
+    REFILTER=0
+  fi
 
   # Atomic lock: mkdir fails if another session races us
-  if ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
+  # (a refilter already holds the lock from the first Read)
+  if [ "$REFILTER" -eq 0 ] && ! mkdir "$CACHE/${ID}.lock" 2>/dev/null; then
     # Lock exists — reclaim only if stale (>60s old, no backup = crash leftover)
     if [ ! -f "$CACHE/${ID}.bak" ] && \
        [ -n "$(find "$CACHE/${ID}.lock" -maxdepth 0 -mmin +1 2>/dev/null)" ]; then
@@ -330,6 +400,19 @@ if [ "$TOOL_NAME" = "Edit" ] || [ "$TOOL_NAME" = "Write" ]; then
   [ -f "$CACHE/${ID}.bak" ] || exit 0
   ls "$CACHE/${ID}".block.* >/dev/null 2>&1 || exit 0
 
+  # The edit removed a placeholder. Expanding now would save a backup without
+  # that block, and Stop would then restore the loss. Keep the last good
+  # backup, leave the file as edited, and tell the model (exit 2 sends stderr
+  # back to it) so it can put the placeholder back; if it does not, Stop
+  # restores the backup and keeps this version as <id>.recovered.
+  if dropped=$(missing_placeholders "$FILE_PATH" "$ID"); then
+    printf '%s\n%s\n%s\n' \
+      "simplify-ignore：本次 $TOOL_NAME 删除了 $FILE_PATH 的占位符行，每行都代表当前不可见的受保护代码（removed placeholder line(s)）：" \
+      "$dropped" \
+      "请逐行原样放回占位符。在此之前备份不会更新；会话结束时将从备份恢复文件，本次改写以 .recovered 留在缓存中（backup is not updated）。" >&2
+    exit 2
+  fi
+
   # Expand placeholders, preserving any inline code the model added around them
   EXPANDED="$CACHE/${ID}.$$.expanded"
   expand_file "$FILE_PATH" "$EXPANDED" "$ID"

package/package.json

@@ -55,6 +55,7 @@
     "evals/cases/i3-source-driven-development.json",
     "evals/cases/i3-spec-driven-development.json",
     "evals/cases/i3-test-driven-development.json",
+    "evals/cases/i3-ui-prototype.json",
     "evals/cases/i3-using-agent-skills.json",
     "evals/fixtures/i3-api-and-interface-design/service-brief.md",
     "evals/fixtures/i3-browser-testing-with-devtools/README.md",
@@ -72,6 +73,8 @@
     "evals/fixtures/i3-debugging-and-error-recovery/time-pressure.md",
     "evals/fixtures/i3-deprecation-and-migration/api-inventory.md",
     "evals/fixtures/i3-documentation-and-adrs/decision-context.md",
+    "evals/fixtures/i3-documentation-and-adrs/prose-review/README.md",
+    "evals/fixtures/i3-documentation-and-adrs/prose-review/queue.js",
     "evals/fixtures/i3-doubt-driven-development/migration-plan.md",
     "evals/fixtures/i3-frontend-ui-engineering/Button.tsx",
     "evals/fixtures/i3-frontend-ui-engineering/design-system.md",
@@ -97,6 +100,7 @@
     "evals/fixtures/i3-test-driven-development/package.json",
     "evals/fixtures/i3-test-driven-development/src/split.js",
     "evals/fixtures/i3-test-driven-development/test/split.test.js",
+    "evals/fixtures/i3-ui-prototype/business-brief.md",
     "evals/fixtures/i3-using-agent-skills/incident.md",
     "evals/fixtures/incremental-implementation-pressure/draft-export.js",
     "evals/fixtures/incremental-implementation-pressure/scenario.md",
@@ -113,6 +117,11 @@
     "evals/plugin/code-review-stays-quiet/graders/not-fired.md",
     "evals/plugin/code-review-stays-quiet/graders/tdd-fired.md",
     "evals/plugin/code-review-stays-quiet/prompt.md",
+    "evals/plugin/tdd-fires-on-pasted-bug/graders/failing-test-first.md",
+    "evals/plugin/tdd-fires-on-pasted-bug/graders/skill-fired.md",
+    "evals/plugin/tdd-fires-on-pasted-bug/prompt.md",
+    "evals/plugin/tdd-stays-quiet-on-debug/graders/not-fired.md",
+    "evals/plugin/tdd-stays-quiet-on-debug/prompt.md",
     "evals/skill-impact.md",
     "evals/zh-CN/cases/i3-api-and-interface-design.json",
     "evals/zh-CN/cases/i3-browser-testing-with-devtools.json",
@@ -138,6 +147,7 @@
     "evals/zh-CN/cases/i3-source-driven-development.json",
     "evals/zh-CN/cases/i3-spec-driven-development.json",
     "evals/zh-CN/cases/i3-test-driven-development.json",
+    "evals/zh-CN/cases/i3-ui-prototype.json",
     "evals/zh-CN/cases/i3-using-agent-skills.json",
     "docs/adoption-guide.md",
     "docs/advanced-per-agent-configuration.md",
@@ -158,12 +168,15 @@
     "plugin.json",
     "README.md",
     "LICENSE",
+    "scripts/enterprise-template-test.js",
     "scripts/floor-guard-reference-test.js",
     "scripts/lib/skill-lint-test.js",
     "scripts/lib/skill-lint.js",
     "scripts/run-evals-test.js",
     "scripts/run-evals.js",
     "scripts/run-regressions.js",
+    "scripts/template-adapter-test.js",
+    "scripts/ui-prototype-test.js",
     "scripts/validate-artifact-paths-test.js",
     "scripts/validate-artifact-paths.js",
     "scripts/validate-commands-test.js",
@@ -227,6 +240,7 @@
       "evals/cases/i3-source-driven-development.json",
       "evals/cases/i3-spec-driven-development.json",
       "evals/cases/i3-test-driven-development.json",
+      "evals/cases/i3-ui-prototype.json",
       "evals/cases/i3-using-agent-skills.json",
       "evals/fixtures/i3-api-and-interface-design/service-brief.md",
       "evals/fixtures/i3-browser-testing-with-devtools/README.md",
@@ -244,6 +258,8 @@
       "evals/fixtures/i3-debugging-and-error-recovery/time-pressure.md",
       "evals/fixtures/i3-deprecation-and-migration/api-inventory.md",
       "evals/fixtures/i3-documentation-and-adrs/decision-context.md",
+      "evals/fixtures/i3-documentation-and-adrs/prose-review/README.md",
+      "evals/fixtures/i3-documentation-and-adrs/prose-review/queue.js",
       "evals/fixtures/i3-doubt-driven-development/migration-plan.md",
       "evals/fixtures/i3-frontend-ui-engineering/Button.tsx",
       "evals/fixtures/i3-frontend-ui-engineering/design-system.md",
@@ -269,6 +285,7 @@
       "evals/fixtures/i3-test-driven-development/package.json",
       "evals/fixtures/i3-test-driven-development/src/split.js",
       "evals/fixtures/i3-test-driven-development/test/split.test.js",
+      "evals/fixtures/i3-ui-prototype/business-brief.md",
       "evals/fixtures/i3-using-agent-skills/incident.md",
       "evals/fixtures/incremental-implementation-pressure/draft-export.js",
       "evals/fixtures/incremental-implementation-pressure/scenario.md",
@@ -285,6 +302,11 @@
       "evals/plugin/code-review-stays-quiet/graders/not-fired.md",
       "evals/plugin/code-review-stays-quiet/graders/tdd-fired.md",
       "evals/plugin/code-review-stays-quiet/prompt.md",
+      "evals/plugin/tdd-fires-on-pasted-bug/graders/failing-test-first.md",
+      "evals/plugin/tdd-fires-on-pasted-bug/graders/skill-fired.md",
+      "evals/plugin/tdd-fires-on-pasted-bug/prompt.md",
+      "evals/plugin/tdd-stays-quiet-on-debug/graders/not-fired.md",
+      "evals/plugin/tdd-stays-quiet-on-debug/prompt.md",
       "evals/skill-impact.md",
       "evals/zh-CN/cases/i3-api-and-interface-design.json",
       "evals/zh-CN/cases/i3-browser-testing-with-devtools.json",
@@ -310,6 +332,7 @@
       "evals/zh-CN/cases/i3-source-driven-development.json",
       "evals/zh-CN/cases/i3-spec-driven-development.json",
       "evals/zh-CN/cases/i3-test-driven-development.json",
+      "evals/zh-CN/cases/i3-ui-prototype.json",
       "evals/zh-CN/cases/i3-using-agent-skills.json",
       "docs/adoption-guide.md",
       "docs/advanced-per-agent-configuration.md",
@@ -331,12 +354,15 @@
       "package.json",
       "README.md",
       "LICENSE",
+      "scripts/enterprise-template-test.js",
       "scripts/floor-guard-reference-test.js",
       "scripts/lib/skill-lint-test.js",
       "scripts/lib/skill-lint.js",
       "scripts/run-evals-test.js",
       "scripts/run-evals.js",
       "scripts/run-regressions.js",
+      "scripts/template-adapter-test.js",
+      "scripts/ui-prototype-test.js",
       "scripts/validate-artifact-paths-test.js",
       "scripts/validate-artifact-paths.js",
       "scripts/validate-commands-test.js",
@@ -348,7 +374,7 @@
       "scripts/validate-versions.js"
     ]
   },
-  "version": "2.2.3",
+  "version": "2.3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/49780522/i3-composer-agent.git"

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.2.3",
+  "version": "2.3.0",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "homepage": "https://github.com/49780522/i3-composer-agent",
   "repository": "https://github.com/49780522/i3-composer-agent"

package/references/performance-checklist.md

@@ -209,14 +209,16 @@ npx vite-bundle-visualizer
 
 # Check bundle size
 npx bundlesize
+```
 
-# Web Vitals in code
+```javascript
+// Web Vitals in code
 import { onLCP, onINP, onCLS } from 'web-vitals';
 onLCP(console.log);
 onINP(console.log);
 onCLS(console.log);
 
-# INP with interaction-level detail (attribution build)
+// INP with interaction-level detail (attribution build)
 import { onINP } from 'web-vitals/attribution';
 onINP(({ value, attribution }) => {
   const { interactionTarget, inputDelay, processingDuration, presentationDelay } = attribution;