Skip to content

v2.8.0 — research skill: conclusion-first 9-section spine

Choose a tag to compare

View all tags
@int2t05 int2t05 released this 19 Aug 06:12
· 4 commits to main since this release
v2.8.0
8249d62

What's new

A bold redesign of the research skill. All three modes (general / market / tech-selection) now share a conclusion-first 9-section spine, extracted to a new report-spine.md to prevent drift and keep SKILL.md lean.

The spine (fixed across modes)

§1 TL;DR (conclusion bullets)
  → §2 核心认知 (mental models + ONE main thread + decision flowchart)
  → §3-§7 主体 (mode-specific)
  → §8 避坑清单 (numbered negative claims with falsification trails)
  → §9 源附录与核查记录 (sources + 负面断言核查记录 + UNVERIFIED + 访问限制与缺口)

Why

The old templates were process-first (§1 = 目标 + 调研方法, conclusion buried at §6/§7) and inconsistent (general 7-section / market mislabeled 6 / tech-selection 10-section). The user's own reference report (2026-08-19-ai-research-tools.md) proved conclusion-first reads better — it opens with "选什么" TL;DR, establishes a single decision main thread in §2, and makes verification visible (避坑清单 + 核查记录) instead of buried.

Key decisions (6 blind spots fixed via pressure-test)

  • Spine extracted to report-spine.md (not inlined in Step 5) — keeps SKILL.md at 136 lines (<150), prevents three-mode drift, follows progressive disclosure.
  • §6 评估 redefined to "per-dimension evidence-backed analysis" — resolves overlap with §1 TL;DR.
  • tech-selection 10→9 — "效果如何" folds into §7 维度核心结论; validation plan moves to §9.4.
  • Dropped mermaid "mixing flowchart/sequenceDiagram" requirement — the reference report uses flowchart-only and is excellent; new rule: ≥1 decision flowchart in §2, general ≥3, each serves information.
  • Glossary optional — inline-explain all jargon; aggregate in §9 only if not all were inline-explained.
  • Fixed pre-existing drift bug — SKILL.md said "6-section market" but market-mode.md had 7; all three now uniformly 9-section.

Also added

  • Step 3: source-code material → git clone --depth 1 into archive/ (gitignored provenance) rather than remote fetch.
  • pressure-scenarios.md: synced scenarios 2/3/5/11 + added 4 new failure modes (结论后置 / 避坑缺失 / 核查记录缺失 / 源码远程读取).

Files (9 changed, +363/−128)

  • references/report-spine.md — NEW (shared spine + skeleton shell)
  • SKILL.md — Step 3 clone note, Step 5 spine pointer, Verify checks, References
  • general-mode.md — 7→9 section + TOC
  • tech-selection-mode.md — 10→9 section, mirrors reference report
  • market-mode.md — 7→9 section
  • pressure-scenarios.md — sync + 4 new scenarios
  • plugin.json, README.md, README.zh-CN.md — version bump 2.7.1 → 2.8.0

Codex adapter (agents/openai.yaml) unchanged — frontmatter description was not modified.

Full diff: v2.7.1...v2.8.0

Assets 2
Loading