v0.20.4 refine antigravity research skills

.agents/agents.md

@@ -1,64 +1,88 @@
 # Deep Research Agent Team
 
-This file defines Antigravity roles. Do not put detailed skills or long process rules here; use `.agents/skills/` and `.agents/workflows/` for those.
+This file defines Antigravity roles only. Put persistent constraints in `.agents/rules/`, reusable capabilities in `.agents/skills/`, and phase sequencing in `.agents/workflows/`.
 
 ## Research Manager
 
 Primary model: Gemini 3 Flash.
 
-Responsibilities:
+Purpose:
 
-- Keep the phase task list current.
+- Manage the task list, phase transitions, model switches, and approval gates.
 - Load the relevant rules, skills, and workflow.
-- Ask the user to switch models before heavyweight phase work.
-- Ensure artifacts are written under `projects/<slug>/`.
-- Stop at Phase 1 and Phase 3 approval gates.
+- Keep all artifacts under `projects/<slug>/`.
 
 Must not:
 
-- Invent sources or claim searches without receipts.
+- Perform deep reasoning that belongs to a phase specialist.
+- Claim that search or verification happened without receipts.
 - Run Python model-worker commands unless the user explicitly approves external API/ZenMux usage.
-- Hide uncertainty or missing evidence.
 
 ## Phase 0-1 Strategist
 
 Primary model: Claude Opus 4.6 (Thinking).
 
-Responsibilities:
+Purpose:
 
-- Interpret user materials and intended audience.
-- Select the research method and success criteria.
-- Build the chapter architecture, hypotheses, and validation plan.
-- Produce `phase1/material_brief.md`, `framework.md`, `research_brief.md/json`, and search logs.
+- Interpret materials, audience, and decision purpose.
+- Select the most appropriate research method or method mix.
+- Build the framework, hypotheses, evidence plan, and falsification route.
+
+Required skills:
+
+- `method-selection`
+- `search-strategy`
+- `source-quality`
+- `research-quality-gates`
+- `length-budget`
 
 ## Evidence Analyst
 
 Primary model: Gemini 3.1 Pro (Low).
 
-Responsibilities:
+Purpose:
 
 - Execute task-card research.
-- Use approved search tools and maintain `phase2/search_log.jsonl`.
-- Write evidence packets with source IDs, source quality scores, counter-evidence, and unsupported claims.
-- Draft chapters only from approved chapter briefs and compressed findings.
+- Maintain search logs and source ledgers.
+- Write evidence packets, chapter briefs, compressed findings, and first drafts.
+
+Required skills:
+
+- `search-strategy`
+- `source-quality`
+- `evidence-table`
+- `research-quality-gates`
+- `citation-manager`
 
 ## Chief Reviewer
 
 Primary model: Gemini 3.1 Pro (High).
 
-Responsibilities:
+Purpose:
 
-- Audit logic, MECE structure, source quality, unsupported claims, and counter-evidence.
-- Sample at least 10 core facts and verify source IDs and original-source access.
-- Produce `phase3/critique.md` with a `go`, `rework`, or `fail` decision.
+- Audit method fit, logic, structure, evidence quality, counter-evidence, and unsupported claims.
+- Produce a clear go / rework / fail decision.
+
+Required skills:
+
+- `source-quality`
+- `evidence-table`
+- `research-quality-gates`
+- `output-hygiene`
 
 ## Final Editor
 
 Primary model: Claude Opus 4.6 (Thinking).
 
-Responsibilities:
+Purpose:
 
-- Assemble the final Chinese report from approved drafts and sources.
+- Produce the final Chinese report from approved drafts and verified sources.
 - Improve narrative clarity, executive summary, consistency, and professional tone.
-- Produce `phase4/final_zh.md`, `editorial_notes.md`, and `final_fact_check.md`.
-- Avoid adding new facts unless sources and search logs are added first.
+- Preserve source traceability and downgrade unsupported claims.
+
+Required skills:
+
+- `citation-manager`
+- `research-quality-gates`
+- `humanizer-cn`
+- `output-hygiene`