Commit Graph
43 Commits
Author SHA1 Message Date
jilinchen 9c79d61747 Add Codex research skills and setup docs
Include Codex setup docs, installer updates, and switch the OpenCode web research agent default model to gpt-5.4.
2026-03-08 23:33:38 +08:00
jilinchen c360ddc185 删除README末尾aaa 2026-03-08 21:52:36 +08:00
jilinchen b8de3633f3 aaa 2026-03-08 21:50:52 +08:00
jilinchenandClaude Opus 4.5 e932c92cc6 Modularize web-search-agent with strategy modules
Split inline search strategies into separate module files (github-debug,
general-web, academic-papers, chinese-tech, stackoverflow). Agent now
loads modules dynamically via Read tool before searching. Update install
instructions to include module files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:24:18 +08:00
jilinchenandClaude Opus 4.5 510b6ba198 Compress workflow.png from 6.8MB to 452KB
- Resize from 2816x1536 to 1408x768
- Apply pngquant compression (quality 70-85)
- 93% size reduction for faster page loads

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 10:52:13 +08:00
jilinchenandClaude Opus 4.5 8919ab2e56 Add workflow diagram to READMEs
- Rename image to workflow.png
- Add workflow image to English and Chinese READMEs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 10:48:06 +08:00
jilinchenandClaude Opus 4.5 5393c79b53 docs: add star reminder to README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 21:41:02 +08:00
jilinchen 6a68406923 support opencode 2026-01-11 14:21:28 +08:00
jilinchenandClaude Opus 4.5 7426ee8383 Add date awareness step to web-search-agent
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 13:55:52 +08:00
jilinchenandClaude Opus 4.5 437bb28e69 refactor: simplify Standard Output Format to if-else structure
- Separate caller's format and standard format as if-else branches
- Add Sources and References (ALWAYS REQUIRED) to both branches

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 12:35:32 +08:00
jilinchenandClaude Opus 4.5 a92028e33b refactor: restructure web-search-agent.md
- Move Scenario-Specific Strategies into Query Generation Phase (1.1-1.3)
- Merge Comparative Research into Best Practices (1.2)
- Add Academic Sources to Source Prioritization
- Merge Self-Verification and Escalation Strategy into Quality Assurance
- Restructure Standard Output Format with PART 1/PART 2 and example
- Add caller's format priority to Compilation Standards
- Update Core Capabilities with new sources

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 12:29:48 +08:00
jilinchen fdb212fe4c feat: add Dev.to, Medium, Discord, X/Twitter to web-search-agent 2026-01-08 11:42:15 +08:00
jilinchen 055b0fcd08 docs: fix wording in en README 2026-01-08 11:36:20 +08:00
jilinchen 5155c76d02 docs: fix wording in zh README 2026-01-08 11:35:38 +08:00
jilinchen b5a4f642d9 docs: add optional step for adding items/fields in workflow 2026-01-08 11:35:17 +08:00
jilinchen 81d75da7ce docs: improve command descriptions in README 2026-01-08 11:33:58 +08:00
jilinchenandClaude Opus 4.5 bb7b8453e2 refactor: flatten skills directory structure
- Restructure skills/research-zh and skills/research-en to flat layout
- Each skill now in its own directory (research, research-deep, etc.)
- Update installation: cp -r skills/research-zh/* ~/.claude/skills/
- Update command references from /research:deep to /research-deep

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 11:30:50 +08:00
jilinchenandClaude Opus 4.5 46529e4b88 feat: support direct slash command trigger (Claude Code 2.1.0+)
- Add user-invocable: true to all SKILL.md files (10 files)
- Update README with new command format (/research:deep)
- Keep backward compatibility notes for older versions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:55:57 +08:00
jilinchen e9dd17b291 simplify validate_json 2026-01-07 12:44:16 +08:00
jilinchenandClaude Opus 4.5 779c447670 fix: address code review issues from Claude and GPT-5.2
- report/SKILL.md: add AskUserQuestion to allowed-tools
- validate_json.py: remove unused imports (List, Any)
- validate_json.py: sort output lists for deterministic order
- validate_json.py: limit recursion to category level only
- validate_json.py: add list-of-dict handling
- EN validate_json.py: remove Chinese from CATEGORY_MAPPING
- EN deep/SKILL.md: change output language from Chinese to English
- deep/SKILL.md: add slug handling for filenames
- report/SKILL.md: fix uncertain_fields -> uncertain naming
- README: add PyYAML dependency note

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:59:18 +08:00
jilinchenandClaude Opus 4.5 98ddfce42d fix: update validate_json.py path from commands to skills
~/.claude/commands/research/ -> ~/.claude/skills/research/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:14:20 +08:00
jilinchenandClaude Opus 4.5 72cd188d52 feat: translate validate_json.py to English for EN version
- Translate all comments and docstrings to English
- Translate CLI help text and output messages to English
- Keep CATEGORY_MAPPING bilingual for compatibility

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:13:18 +08:00
jilinchenandClaude Opus 4.5 066e22fb1d docs: add both language options to Installation section
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:10:25 +08:00
jilinchenandClaude Opus 4.5 09c291a14c docs: add help section with Claude Code prompt to both READMEs
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:08:56 +08:00
jilinchenandClaude Opus 4.5 38e0350f18 docs: make workflow examples beginner-friendly
- Replace raw YAML/JSON with plain language explanations
- Add "What happens" and "You get" for each phase
- More intuitive for newcomers

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:06:03 +08:00
jilinchenandClaude Opus 4.5 013cc823b6 docs: add real workflow examples from AI Agent Demo research
- Show actual outline.yaml, JSON output, and report
- Keep examples concise and elegant

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:03:28 +08:00
jilinchenandClaude Opus 4.5 5dcafa4ef0 docs: split README into separate EN/ZH files
- README.md for English (default)
- README.zh.md for Chinese
- Add language switch links at top

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 02:00:15 +08:00
jilinchen 36b879ae95 update introduction 2026-01-07 01:58:54 +08:00
jilinchenandClaude Opus 4.5 366444969a docs: fix command syntax - use 'run /research' instead of '/research'
- Add note about slash command conflict with built-in commands
- Update all command examples to use 'run' prefix

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 01:56:00 +08:00
jilinchenandClaude Opus 4.5 39abbd0be3 docs: add workflow phase descriptions
- Add detailed explanations for each workflow phase
- Describe outputs for each stage

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 01:54:05 +08:00
jilinchenandClaude Opus 4.5 5ae9dbf2a6 docs: update README with agents directory structure
- Move web-search-agent.md to agents/
- Add agent installation instructions

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 01:52:50 +08:00
jilinchenandClaude Opus 4.5 10377e95e2 feat: add bilingual support (zh/en) for research skills
- Rename skills/research to skills/research-en (English version)
- Add skills/research-zh (Chinese version with SKILL.md structure)
- Update README.md with bilingual documentation
- Add web-search-agent.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 01:48:55 +08:00
jilinchenandClaude Opus 4.5 92b47e006e docs: translate all SKILL.md files to English
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 11:48:37 +08:00
jilinchenandClaude Opus 4.5 11a51a8d79 feat: enhance research workflow with user confirmations
- Add AskUserQuestion for Step 1 framework confirmation
- Add TOC summary field selection in report generation
- Add detail_level hierarchy (brief -> moderate -> detailed)
- Add Chinese output requirement for JSON values
- Add long text formatting rules

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-31 11:45:24 +08:00
jilinchenandClaude Opus 4.5 5eaf859274 feat: enhance research skills with validation and English translation
- Add validate_json.py for field coverage validation
- Add hard constraints and one-shot examples to prompt templates
- Add parameter retrieval sections before prompts
- Translate all SKILL.md files to English
- Update report.md with technical requirements

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 13:23:34 +08:00
jilinchenandClaude Opus 4.5 a34ef20fd4 feat: add /research/report command for markdown generation
- New report command to generate markdown from JSON results
- Generates Python script for conversion
- Creates report with TOC and anchor links
- Skips uncertain fields and uncertain array
- Update deep.md with prompt template format

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 11:48:10 +08:00
jilinchenandClaude Opus 4.5 620a6622fd refactor: main agent only reads outline, not fields
- Remove fields.yaml reading from Step 1 (main agent)
- Each web-search-agent reads fields.yaml independently (hard constraint)
- Update uncertainty marking format

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 11:22:35 +08:00
jilinchenandClaude Opus 4.5 2d20e5739a feat: add uncertainty marking for research fields
- Add uncertain field to fields.yaml (reserved, auto-filled in deep phase)
- Hard constraint: mark uncertain values with [bu que ding] in field value
- Hard constraint: list uncertain field names in JSON uncertain array

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 11:18:30 +08:00
jilinchenandClaude Opus 4.5 f0348451af feat: add items_per_agent execution config
- Add items_per_agent field to control items per agent
- Confirm via AskUserQuestion in /research phase
- Deep research reads from outline config directly

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 10:52:35 +08:00
jilinchenandClaude Opus 4.5 6796214afe docs: specify execution config fields
- batch_size: parallel agent count (default: 5)
- output_dir: results directory (default: ./results)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 10:46:33 +08:00
jilinchenandClaude Opus 4.5 302f2733d3 refactor: separate outline.yaml and fields.yaml
- Output to {topic}/ directory structure
- fields.yaml now independent file for field definitions
- outline.yaml contains items + execution config
- Deep research agents read fields.yaml independently (hard constraint)
- Update README with new directory structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 10:42:58 +08:00
jilinchen 906821b296 update readme 2025-12-29 13:06:19 +08:00
jilinchen 87141ecfb0 Initial commit: Deep Research Skill for Claude Code 2025-12-29 12:58:39 +08:00