/update-readme
Update README documentation and push changes to GitHub.
> /plugin marketplace add Galaxy-Dawn/claude-scholar > /plugin install claude-scholar@claude-scholar
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/update-readme
Context preview
What this command does when you run it.
Update README documentation and push changes to GitHub.
Command definition
update-readme.mddescription: Update README documentation and push changes to GitHub.
Update README
Update README.md file with latest project information and push to GitHub.
Instructions
1. **Analyze Current State**
- Read existing README.md
- Check recent code changes (git log)
- Identify documentation gaps
2. **Determine Updates Needed** Check for:
- New features added
- Configuration changes
- Dependencies updated
- Installation instructions
- Usage examples
- API changes
3. **Propose README Updates** Show sections that need updating:
Proposed changes:
- [ ] Update Installation section (new dependencies)
- [ ] Add usage example for feature X
- [ ] Update API documentation
- [ ] Fix broken links
4. **Update README**
- Apply proposed changes
- Maintain markdown formatting
- Keep language consistent (中文/English)
- Preserve structure
5. **Commit and Push**
- Run `/update-github` with `docs(readme):` type
- Example commit: `docs(readme): 更新 README 文档`
Example Usage
User: /update-readme
1. Analyzing repository state...
Recent changes:
- feat(data): 添加新的数据加载器
- fix(model): 修复训练时的内存泄漏
- chore: 更新依赖到 v2.0.0
2. Checking README.md...
Current README sections:
- Installation
- Usage
- API Reference
- Contributing
3. Proposed updates:
[ ] Installation - 添加新的依赖说明
[ ] Usage - 添加数据加载器示例
[ ] API Reference - 更新模型接口文档
4. Applying updates...
Updating Installation:
+ pip install torch>=2.0.0
+ pip install transformers>=4.30.0
Adding usage example:
## 数据加载示例
```python
from data import DataLoader
loader = DataLoader(batch_size=32)
5. Review changes before committing... [Show diff]
6. Proceed with commit? > yes
7. Committing with: docs(readme): 更新 README 文档 Co-Authored-By: Claude <noreply@anthropic.com>
✅ README updated and pushed to GitHub!
## README Structure Template
When updating README, follow this structure:
```markdown
# 项目名称
简短描述项目用途。
## 安装
### 依赖要求
- Python >= 3.8
- uv 或 pip
### 安装步骤
```bash
uv sync
使用
基本用法
# 示例代码
配置
说明配置文件位置和格式。
API 文档
主要接口说明。
开发
运行测试
pytest
代码规范
- 遵循 PEP 8
- 使用 mypy 进行类型检查
- 使用 ruff 进行 linting
贡献
欢迎提交 Pull Request。
许可证
MIT License
## Arguments
$ARGUMENTS can be:
- `--full` - Complete README rewrite
- `--quick` - Only update critical sections (installation, usage)
- `<section>` - Update specific section only
## Integration
After updating README, this command automatically invokes `/update-github` with `docs(readme):` commit type.
Read more
description: Update README documentation and push changes to GitHub.
Update README
Update README.md file with latest project information and push to GitHub.
Instructions
1. **Analyze Current State**
- Read existing README.md
- Check recent code changes (git log)
- Identify documentation gaps
2. **Determine Updates Needed** Check for:
- New features added
- Configuration changes
- Dependencies updated
- Installation instructions
- Usage examples
- API changes
3. **Propose README Updates** Show sections that need updating:
Proposed changes: - [ ] Update Installation section (new dependencies) - [ ] Add usage example for feature X - [ ] Update API documentation - [ ] Fix broken links
4. **Update README**
- Apply proposed changes
- Maintain markdown formatting
- Keep language consistent (中文/English)
- Preserve structure
5. **Commit and Push**
- Run `/update-github` with `docs(readme):` type
- Example commit: `docs(readme): 更新 README 文档`
Example Usage
User: /update-readme 1. Analyzing repository state... Recent changes: - feat(data): 添加新的数据加载器 - fix(model): 修复训练时的内存泄漏 - chore: 更新依赖到 v2.0.0 2. Checking README.md... Current README sections: - Installation - Usage - API Reference - Contributing 3. Proposed updates: [ ] Installation - 添加新的依赖说明 [ ] Usage - 添加数据加载器示例 [ ] API Reference - 更新模型接口文档 4. Applying updates... Updating Installation: + pip install torch>=2.0.0 + pip install transformers>=4.30.0 Adding usage example: ## 数据加载示例 ```python from data import DataLoader loader = DataLoader(batch_size=32)
5. Review changes before committing... [Show diff]
6. Proceed with commit? > yes
7. Committing with: docs(readme): 更新 README 文档 Co-Authored-By: Claude <noreply@anthropic.com>
✅ README updated and pushed to GitHub!
## README Structure Template When updating README, follow this structure: ```markdown # 项目名称 简短描述项目用途。 ## 安装 ### 依赖要求 - Python >= 3.8 - uv 或 pip ### 安装步骤 ```bash uv sync
使用
基本用法
# 示例代码
配置
说明配置文件位置和格式。
API 文档
主要接口说明。
开发
运行测试
pytest
代码规范
- 遵循 PEP 8
- 使用 mypy 进行类型检查
- 使用 ruff 进行 linting
贡献
欢迎提交 Pull Request。
许可证
MIT License
## Arguments $ARGUMENTS can be: - `--full` - Complete README rewrite - `--quick` - Only update critical sections (installation, usage) - `<section>` - Update specific section only ## Integration After updating README, this command automatically invokes `/update-github` with `docs(readme):` commit type.
Semi-automated research assistant for academic research and software development. Supports Claude Code, Codex CLI, Kimi Code CLI, and OpenCode across ideation, coding, experiments, writing, and publication.
Repo: Galaxy-Dawn/claude-scholar
Other commands on claude-scholar.
- /analyze-results
Optional experiment line slug for report naming
Open command - /build-fix
Incrementally fix Python type and lint errors:
Open command - /checkpoint
Create or verify a checkpoint in your workflow.
Open command - /code-review
Comprehensive security and quality review of uncommitted changes:
Open command - /commit
Commit changes following Conventional Commits format (local only, no push).
Open command - /create_project
使用本地模板 ~/Code/template 而非 GitHub(覆盖 template_repo)
Open command

