7 Commits

Author SHA1 Message Date
xsser 1be1c478b6 release: v3.2.0 — teardown protocol (agent lifecycle accounting)
PUA v3.1 之前覆盖 agent 生命周期的前 4 阶段(Define → Spawn → Monitor →
Accept),缺后 3 阶段(Release → Cleanup → Orphan handling),导致验收通过的
agent 堆在上下文、worktree 变孤儿、tmux pane 常驻、后台 agent 永久吃 token。
v3.2 补齐会计层:SubagentStop hook + 3 个新 slash 命令 + teardown 协议文档。

Why (Netflix Keeper Test): 职业球队里打完比赛的球员必须下场,继续站场上只会
拖垮全队节奏。agent 也一样。

What:
- NEW hooks/subagent-teardown.sh — SubagentStop 会计,写 teardown.jsonl +
  从 active-agents.json 移除(单行 compact jsonl)
- NEW commands/team-status.md — 列在场阵容(活跃 agent / PID / TTL / age)
- NEW commands/reap-orphans.md — 扫 stale agent(mtime > 30min)批量回收
- NEW commands/teardown-all.md — 级联释放 P10 → P9 → P8 → P7 全员下场
- NEW skills/pua/references/teardown-protocol.md — 生命周期 7 阶段协议 +
  6 条 Release 规则 + Cleanup checklist + Orphan 三层防御

Bugfix:
- hooks/pua-loop-hook.sh: 新增 Gate 0(SubagentStop isolation),state file
  路径改为绝对路径 $HOME/.claude/pua/loop-active.md(SESSION_ID 在 setup
  时不可用,固定名)+ legacy fallback
- scripts/setup-pua-loop.sh: ABS + legacy 双写 state
- hooks/hooks.json: 注册 SubagentStop → subagent-teardown.sh
- commands/on.md: 修复 feedback_frequency=0 tombstone 不恢复的不对称 bug
- commands/cancel-pua-loop.md + team-status.md: 移除不支持的
  Read(~/...) tilde 权限语法

E2E 验证 (10/10 全绿):
T1 hooks.json syntax | T2 teardown jsonl compact | T3 active-agents 选择性清除
T4 setup 双写 MD5 identical | T5 Gate 0 真拦截 SubagentStop
T6 主会话 Stop 注入 decision:block valid JSON | T7 Gate 0 对带 transcript
的 sub 仍拦截 | T8 无 tilde | T9 feedback_frequency 恢复 | T10 SubagentStop 注册
2026-04-18 02:40:57 +08:00
xsser bb23af0da0 feat(v3): intelligent methodology routing + code-level behavioral detection
BREAKING: Version bumped to 3.0.0

## Methodology Router
- Auto-select best methodology by task type (Debug→Huawei RCA, Build→Musk Algorithm, Research→Baidu Search-First, Architecture→Amazon Working Backwards, etc.)
- Failure-mode switch chains: when current methodology fails, auto-switch to next (e.g., Spinning→Musk→Pinduoduo→Huawei)
- Pre-switch validation: 3 questions before switching to prevent invalid switches
- User manual flavor override always takes priority over auto-routing

## Hook System (Claude Code only)
- SessionStart: additionalContext JSON injection (system-level, not advisory) — injects behavioral protocol + methodology + router table + anti-rationalization table
- PostToolUse (Bash): consecutive failure detection with L1→L4 pressure escalation + methodology switch suggestions at L2, mandatory switch at L4
- UserPromptSubmit: frustration phrase interception (25 CN/EN trigger words) — injects PUA enforcement BEFORE model responds
- All hooks flavor-aware via shared flavor-helper.sh

## 13 Complete Methodologies
- NEW: methodology-amazon.md (Working Backwards + 6-Pager + Bar Raiser + Single-Threaded Owner)
- NEW: methodology-jd.md (Customer experience red line + flat ≤5 layers + data zero tolerance)
- NEW: methodology-xiaomi.md (参与感三三法则 + explosive product focus + loyalty→WOM→awareness path)
- NEW: methodology-router.md (routing rules + switch chains)
- FIXED: musk→methodology-tesla.md mapping (was missing)
- FIXED: jobs→methodology-apple.md mapping (was missing)
- All 13 flavors now have inline methodology in flavor-helper.sh + full methodology files

## SKILL.md Overhaul
- Removed hardcoded Alibaba-only aside protocol — now flavor-aware
- Added methodology router table (task type → recommended flavor)
- Updated pressure escalation table: L2 suggests methodology switch, L4 forces it
- Updated failure mode table with switch chains
- Added pre-switch validation (3 questions)
- Added methodology-router.md to mandatory reading list

## README/Landing
- Updated EN/CN/JP README with v3 section
- Updated 13 Corporate Flavors table to include methodologies
- Updated architecture diagram with hook system
- Updated landing page i18n.ts with v3 messaging
2026-03-24 18:56:06 +08:00
xxnbyy f1ca48a417 fix(plugin): sync version to 2.9.0 across root plugin.json and marketplace.json
Root plugin.json was stuck at 2.2.0 — marketplace validation reads this file
and the version mismatch caused installation errors for marketplace users.
marketplace.json was at 2.8.0, also behind .claude-plugin/plugin.json (2.9.0).
2026-03-22 21:55:52 +08:00
xsser 76a83507a6 fix: remove hooks from root plugin.json too — also breaks marketplace validation 2026-03-19 21:26:30 +08:00
xsser ff3867c798 fix(trigger): add Chinese quality complaint keywords to description
Test 5 "交付质量太差" failed to trigger — description lacked Chinese
quality complaint phrases. Added: 质量太差, 重新做, 你再试试,
为什么还不行, 你怎么又失败了. Re-test passed 6/6.
2026-03-19 16:32:39 +08:00
xsser 3a3a500e71 feat(v2.2): major refactor based on Anthropic skill best practices
SKILL.md: 653 → ~220 lines (token reduction ~60%)
- Add Hard Gates (3 non-bypassable rules replacing soft 铁律)
- Add Gotchas section (Anthropic: "highest-signal content in any skill")
- Add Skill composition protocol (explicit integration with superpowers)
- Merge 抗合理化表 + 压力升级 into single decision table
- Extract display protocol to references/display-protocol.md
- Extract Agent Team to references/agent-team.md
- Add display density auto-adjustment (no Banner for simple tasks)
- Rewrite description as trigger-focused (Anthropic: "when to use, not what it does")

New files:
- references/display-protocol.md — Sprint Banner, KPI card, progress bar templates
- references/agent-team.md — P7/P8/P9/P10 architecture, parallel protocols
- evals/trigger-prompts/ — should-trigger + should-not-trigger test prompts
- evals/run-trigger-test.sh — automated triggering evaluation script

plugin.json: v2.1.0 → v2.2.0, trigger-focused description
2026-03-19 16:14:59 +08:00
xsser e23b6b9cfa feat(hooks): add compaction state protection via builder-journal
- PreCompact hook (prompt): instructs Claude to dump PUA runtime state
  (pressure level, failure count, tried approaches) to ~/.puav2/builder-journal.md
- SessionStart hook (command): restores state from builder-journal.md
  after compaction (matcher: compact) or session resume (matcher: startup|resume)
- Uses correct Claude Code plugin hook format: hooks/hooks.json file reference
  with nested matcher + hooks array structure
- plugin.json bumped to v2.1.0
2026-03-19 15:11:23 +08:00