Commit Graph
46 Commits
Author SHA1 Message Date
Lan ZhengandGitHub e5479f857f Add MIT License to the project 2026-05-08 00:08:06 +08:00
jilinchenandClaude Opus 4.6 dc18cf4591 Fix missing frontmatter name fields and hardcoded paths in skills
Add missing `name` field to all research-zh and research-en SKILL.md
frontmatter (fixes #1). Replace hardcoded /home/weizhena/ paths with
~ and {project_dir} placeholders in research-deep skills (fixes #2).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10 12:44:31 +08:00
jilinchen 014b5d0e41 Document OpenCode EXA web search setup 2026-03-09 00:12:08 +08:00
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