pulse-coder-cli 0.0.1-alpha.1

package/.pulse-coder/skills/deep-research/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: deep-research
+description: Conduct comprehensive multi-round research using iterative web searches to gather, analyze, and synthesize information
+version: 1.0.0
+author: Pulse Coder Team
+---
+
+# Deep Research Skill
+
+This skill enables comprehensive research through iterative web searches, allowing you to explore topics in depth by conducting 5-10 rounds of focused searches.
+
+## When to Use
+
+Use deep-research when you need to:
+- Gather comprehensive information on complex topics
+- Compare multiple approaches or solutions
+- Understand emerging technologies or trends
+- Research best practices across different sources
+- Investigate technical problems with multiple facets
+- Build a complete picture of a topic before making decisions
+
+## Research Process
+
+### 1. Initial Exploration (Rounds 1-2)
+- Start with broad search queries to understand the topic landscape
+- Identify key concepts, technologies, and terminology
+- Note knowledge gaps and areas requiring deeper investigation
+
+### 2. Focused Investigation (Rounds 3-6)
+- Refine queries based on initial findings
+- Dive deeper into specific subtopics
+- Compare different approaches or solutions
+- Gather technical details and implementation examples
+- Look for authoritative sources and documentation
+
+### 3. Synthesis & Validation (Rounds 7-10)
+- Cross-reference information from multiple sources
+- Validate findings with official documentation
+- Look for recent updates or changes (2024-2026)
+- Identify consensus vs. controversial aspects
+- Fill remaining knowledge gaps
+
+## Using the Tavily Tool
+
+The `tavily` tool is available for web searches:
+
+```typescript
+// Example usage
+await tavily.execute({
+  query: "your search query here",
+  maxResults: 5  // Optional, defaults to 5
+});
+```
+
+## Search Strategy Tips
+
+**Progressive Refinement**
+- Round 1-2: Broad overview queries
+- Round 3-5: Specific technical details
+- Round 6-8: Edge cases and best practices
+- Round 9-10: Recent updates and validation
+
+**Query Formulation**
+- Use specific technical terms when available
+- Include year (2024-2026) for recent information
+- Combine technology names with action words (e.g., "implement", "compare", "best practices")
+- Ask about trade-offs and limitations
+
+**Information Quality**
+- Prioritize official documentation
+- Look for recent blog posts from experts
+- Check GitHub repositories for real examples
+- Compare multiple sources for accuracy
+
+## Output Structure
+
+Present your research findings in this format:
+
+**Overview**
+- Brief summary of the topic
+- Key findings and main takeaways
+
+**Detailed Findings**
+- Organized by subtopic or theme
+- Include specific technical details
+- Reference sources for important claims
+
+**Comparison & Trade-offs** (if applicable)
+- Different approaches or solutions
+- Pros and cons of each
+- Recommended scenarios for each option
+
+**Implementation Guidance** (if applicable)
+- Step-by-step approach
+- Code examples or patterns
+- Common pitfalls to avoid
+
+**Sources**
+- List all URLs consulted
+- Group by relevance or topic
+
+## Example Research Flow
+
+**Topic: "Best practices for React Server Components in Next.js 14"**
+
+Round 1: "React Server Components overview 2024"
+Round 2: "Next.js 14 Server Components features"
+Round 3: "Server Components vs Client Components when to use"
+Round 4: "React Server Components data fetching patterns"
+Round 5: "Next.js 14 Server Components performance"
+Round 6: "Server Components best practices 2024"
+Round 7: "Common mistakes React Server Components"
+Round 8: "Server Components with Suspense and streaming"
+Round 9: "Production experiences Server Components"
+Round 10: "Server Components migration guide"
+
+## Important Notes
+
+- Each search builds on previous findings
+- Adapt your strategy based on what you learn
+- Don't repeat identical queries
+- Balance breadth and depth appropriately
+- Always cite sources in your final output
+- Focus on actionable insights, not just information gathering

package/.pulse-coder/skills/git-workflow/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: git-workflow
+description: Standard git workflow for handling staged changes on existing branch - add, commit, and push
+description_zh: 在现有分支上处理已暂存代码的标准 git 工作流程 - 添加、提交和推送
+version: 1.2.0
+author: Pulse Coder Team
+---
+
+# Git Workflow Skill
+
+这个 skill 提供了一个简化的 git 工作流程，专注于在当前分支上处理更改，不创建新分支。
+
+## 工作流程步骤
+
+### 1. 检查当前状态
+```bash
+git status
+```
+检查当前分支状态，识别：
+- 已修改的文件 (modified files)
+- 未跟踪的文件 (untracked files)
+- 已暂存的文件 (staged files)
+
+### 2. 添加更改到暂存区
+```bash
+git add <files...>
+```
+根据情况选择：
+- `git add .` - 添加所有更改
+- `git add -A` - 添加所有文件（包括删除的）
+- `git add <specific-files>` - 只添加特定文件
+
+### 3. 提交更改
+```bash
+git commit -m "<type>: <short description>"
+```
+
+提交消息格式：
+```
+<type>: <short description>
+
+- <详细描述点1>
+- <详细描述点2>
+```
+
+类型包括：
+- `feat` - 新功能
+- `fix` - 修复
+- `refactor` - 重构
+- `docs` - 文档
+- `style` - 格式调整
+- `test` - 测试
+- `chore` - 构建/工具
+
+### 4. 推送到远程仓库
+```bash
+git push
+```
+
+## 快速工作流程
+
+```bash
+# 一键完成
+git status
+git add .
+git commit -m "描述更改内容"
+git push
+```
+
+## 选择性工作流程
+
+### 只添加特定文件
+```bash
+git add src/ docs/
+git commit -m "feat: 更新核心功能和文档"
+git push
+```
+
+### 分批次提交
+```bash
+git add src/app.ts
+git commit -m "feat: 添加新功能"
+git add tests/
+git commit -m "test: 添加对应测试"
+git push
+```
+
+## 验证步骤
+
+完成每个步骤后验证：
+1. `git status` - 确认工作目录干净
+2. `git log --oneline -3` - 查看最新提交
+3. `git branch` - 确认当前分支

package/.pulse-coder/skills/mr-generator/README.md

@@ -0,0 +1,96 @@
+# MR Generator Skill
+
+Automatically generate concise English MR titles and descriptions based on diff between current branch and remote master.
+
+## Quick Start
+
+```bash
+# Make it globally available
+ln -sf "$(pwd)/.coder/skills/mr-generator/mr-generate.sh" /usr/local/bin/mr-generate
+
+# Basic usage
+mr-generate
+
+# With options
+mr-generate --target origin/develop
+mr-generate --preview
+```
+
+## Integration Examples
+
+### GitHub CLI
+```bash
+# Create MR with auto-generated title/description
+git push origin HEAD
+mr-generate | gh pr create --title "$(head -1)" --body "$(tail -n +3)"
+```
+
+### GitLab CLI
+```bash
+# GitLab MR creation
+git push origin HEAD
+mr-generate | glab mr create --title "$(head -1)" --description "$(tail -n +3)"
+```
+
+### Manual Copy
+```bash
+# Preview before creating MR
+mr-generate --preview
+# Then copy title/description manually
+```
+
+## How It Works
+
+1. **Diff Analysis**: Compares current branch with target (default: origin/master)
+2. **Change Classification**: Analyzes file types and patterns
+3. **Module Detection**: Identifies main functional areas
+4. **Smart Generation**: Creates context-appropriate titles and descriptions
+
+## Output Examples
+
+### Feature Development
+```
+Add user authentication with JWT
+
+Implement secure user authentication using JWT tokens
+
+- Add login/logout endpoints
+- Implement token validation middleware
+- Add user registration flow
+```
+
+### Bug Fix
+```
+Fix email validation in login form
+
+Resolve email format validation issue causing login failures
+
+- Update email regex pattern
+- Add proper error handling
+- Add validation tests
+```
+
+### Refactoring
+```
+Refactor API response handling
+
+Improve API response consistency and error handling
+
+- Standardize response format
+- Add centralized error handling
+- Reduce code duplication
+```
+
+## Configuration
+
+### Environment Variables
+```bash
+export MR_TARGET_BRANCH=origin/main    # Default target branch
+export MR_MAX_TITLE_LENGTH=50          # Title length limit
+```
+
+### Git Aliases
+```bash
+git config alias.mr-title "!.coder/skills/mr-generator/mr-generate.sh"
+git config alias.mr-preview "!.coder/skills/mr-generator/mr-generate.sh --preview"
+```

package/.pulse-coder/skills/mr-generator/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: mr-generator
+description: Automatically generate concise MR titles and descriptions based on current branch diff
+description_zh: 基于当前分支与远程 master 的 diff 自动生成简洁英文 MR 标题和描述的 skill。
+version: 1.0.0
+author: Pulse Coder Team
+---
+# MR Generator Skill
+
+基于当前分支与远程 master 的 diff 自动生成简洁英文 MR 标题和描述的 skill。
+
+## 核心功能
+
+### 1. 智能 diff 分析
+- 分析文件变更类型和范围
+- 识别主要功能模块
+- 提取关键变更点
+
+### 2. 自动标题生成
+- 基于变更类型选择合适的动词
+- 包含主要功能模块
+- 保持在 50 字符以内
+
+### 3. 简洁描述生成
+- 列出核心变更点
+- 使用项目符号格式
+- 英文简洁表达
+
+## 使用方式
+
+### 基本使用
+```bash
+# 生成 MR 标题和描述
+./mr-generate.sh
+
+# 指定目标分支（默认 origin/master）
+./mr-generate.sh --target origin/develop
+
+# 预览模式
+./mr-generate.sh --preview
+```
+
+### 集成到工作流
+```bash
+# 在创建 MR 前运行
+git push origin HEAD
+./mr-generate.sh | gh pr create --title "$(head -1)" --body "$(tail -n +3)"
+```
+
+## 标题生成规则
+
+### 变更类型映射
+- **新功能**: Add / Implement / Introduce
+- **修复**: Fix / Resolve / Correct
+- **重构**: Refactor / Improve / Optimize
+- **文档**: Update / Add docs
+- **测试**: Add tests / Improve coverage
+- **配置**: Update config / Setup
+
+### 模块提取
+- 基于文件路径识别主要模块
+- 优先使用业务功能名称
+- 简洁技术术语
+
+## 描述格式
+
+```
+Brief description of changes
+
+- Key change 1
+- Key change 2
+- Impact or improvement
+```
+
+## 示例输出
+
+### 功能开发
+**标题**: `Add user authentication with JWT`
+
+**描述**:
+```
+Implement secure user authentication using JWT tokens
+
+- Add login/logout endpoints
+- Implement token validation middleware
+- Add user registration flow
+- Update API documentation
+```
+
+### Bug 修复
+**标题**: `Fix login validation error`
+
+**描述**:
+```
+Resolve email validation issue in user login
+
+- Fix regex pattern for email validation
+- Add proper error handling for invalid formats
+- Update unit tests for edge cases
+```
+
+### 重构
+**标题**: `Refactor API response handling`
+
+**描述**:
+```
+Improve API response consistency and error handling
+
+- Standardize response format across endpoints
+- Add centralized error handling middleware
+- Reduce code duplication in controllers
+- Update test assertions
+```