abhishekbhakat/droid_rules
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

skill initial

Browse Source
This commit is contained in:
abhishekbhakat
2026-02-06 16:21:11 +05:30
parent ac213793b0
commit 229070be0b
7 changed files with 397 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
DROIDS.md
View File

@@ -11,7 +11,7 @@ Factory Droids uses `droid exec` to run AI agents non-interactively, each specia
```bash
droid exec --help # Show exec command options (includes model list)
droid --help # Show all droid commands
droid exec --list-tools # List available tools for a model
droid exec --model custom:Kimi-K2.5 --list-tools # List available tools for a model
```
> **Tip:** Run `droid exec --help` to see all available models including BYOK custom models.
@@ -20,56 +20,56 @@ droid exec --list-tools # List available tools for a model
```bash
# Read-only analysis (default)
droid exec "analyze the codebase structure"
droid exec --model custom:Kimi-K2.5 "analyze the codebase structure"
# With file input
droid exec -f prompt.txt
droid exec --model custom:Kimi-K2.5 -f prompt.txt
# With specific model
droid exec --model custom:kimi-k2.5 "explore the project"
droid exec --model custom:Kimi-K2.5 "explore the project"
# Low autonomy - safe file operations
droid exec --auto low "add JSDoc comments"
droid exec --model custom:Kimi-K2.5 --auto low "add JSDoc comments"
# Medium autonomy - development tasks
droid exec --auto medium "install deps and run tests"
droid exec --model custom:Kimi-K2.5 --auto medium "install deps and run tests"
# High autonomy - production operations
droid exec --auto high "fix, test, commit and push"
droid exec --model custom:Kimi-K2.5 --auto high "fix, test, commit and push"
```
## Available Models (BYOK)
| Model ID | Name | Reasoning |
|-----------------------------------|----------------------|-----------|
| `custom:kimi-k2.5` | Kimi K2.5 | Yes |
| `custom:claude-opus-4.6` | Claude Opus 4.6 | Yes |
| `custom:gpt-5.3-codex` | GPT 5.3 Codex | Yes |
| `custom:gpt-5.2` | GPT 5.2 | Yes |
| `custom:Kimi-K2.5` | Kimi K2.5 | Yes |
| `custom:Opus-4.6` | Opus 4.6 | Yes |
| `custom:Gpt-5.3-Codex` | Gpt 5.3 Codex | Yes |
| `custom:Gpt-5.2` | Gpt 5.2 | Yes |
## Droid Roles
| Droid | Model | Purpose | Auto Level |
|------------|-------------------------------|---------------------------------------|------------|
| Explorer | `custom:kimi-k2.5` | Code exploration and research | high |
| Spec | `custom:gpt-5.2` | Planning and specification generation | high |
| Coder | `custom:gpt-5.3-codex` | Large code generation | high |
| Coder-lite | `custom:kimi-k2.5` | Small code generation and fixes | high |
| Quality | `custom:kimi-k2.5` | Formatting, linting, type checking | high |
| Reviewer | `custom:claude-opus-4-6` | Code review and bug finding | high |
| Runner | `custom:kimi-k2.5` | Build, test, and execution | high |
| Explorer | `custom:Kimi-K2.5` | Code exploration and research | high |
| Spec | `custom:Gpt-5.2` | Planning and specification generation | high |
| Coder | `custom:Gpt-5.3-Codex` | Large code generation | high |
| Coder-lite | `custom:Kimi-K2.5` | Small code generation and fixes | high |
| Quality | `custom:Kimi-K2.5` | Formatting, linting, type checking | high |
| Reviewer | `custom:Opus-4.6` | Code review and bug finding | high |
| Runner | `custom:Kimi-K2.5` | Build, test, and execution | high |
## Workflow
1. **Start** with a good instruction follower (`custom:kimi-k2.5` or `custom:gpt-5.3-codex`)
1. **Start** with `custom:Kimi-K2.5` as the driver and entrypoint
2. **Make** a todo list
3. **Explore** - Launch multiple explorer droids with `custom:kimi-k2.5` in parallel
4. **Spec** - Evaluate context with spec droid using `custom:gpt-5.2`
3. **Explore** - Launch multiple explorer droids with `custom:Kimi-K2.5` in parallel
4. **Spec** - Evaluate context with spec droid using `custom:Gpt-5.2`
5. **Confirm** spec with user
6. **Code** - Use `custom:gpt-5.3-codex` for large code gen, `custom:kimi-k2.5` for small
7. **Quality** - Run quality check droid with `custom:kimi-k2.5 --auto high`
8. **Review** - Run review droid with `custom:claude-opus-4-6 --auto high`
9. **Run** - Run build/test droid with `custom:kimi-k2.5 --auto high`
6. **Code** - Use `custom:Gpt-5.3-Codex` for large code gen, `custom:Kimi-K2.5` for small
7. **Quality** - Run quality check droid with `custom:Kimi-K2.5 --auto high`
8. **Review** - Run review droid with `custom:Opus-4.6 --auto high`
9. **Run** - Run build/test droid with `custom:Kimi-K2.5 --auto high`
10. **Summarize** - Provide final summary
## Autonomy Levels
@@ -112,27 +112,27 @@ Options:
Create API key: https://app.factory.ai/settings/api-keys
```bash
export FACTORY_API_KEY=fk-... && droid exec "fix the bug"
export FACTORY_API_KEY=fk-... && droid exec --model custom:Kimi-K2.5 "fix the bug"
```
## Examples
```bash
# Analysis (read-only)
droid exec "Review the codebase for security vulnerabilities"
droid exec --model custom:Kimi-K2.5 "Review the codebase for security vulnerabilities"
# Documentation
droid exec --auto low "add JSDoc comments to all functions"
droid exec --auto low "fix typos in README.md"
droid exec --model custom:Kimi-K2.5 --auto low "add JSDoc comments to all functions"
droid exec --model custom:Kimi-K2.5 --auto low "fix typos in README.md"
# Development
droid exec --auto medium "install deps, run tests, fix issues"
droid exec --auto medium "update packages and resolve conflicts"
droid exec --model custom:Kimi-K2.5 --auto medium "install deps, run tests, fix issues"
droid exec --model custom:Kimi-K2.5 --auto medium "update packages and resolve conflicts"
# Production
droid exec --auto high "fix bug, test, commit, and push to main"
droid exec --auto high "deploy to staging after running tests"
droid exec --model custom:Kimi-K2.5 --auto high "fix bug, test, commit, and push to main"
droid exec --model custom:Kimi-K2.5 --auto high "deploy to staging after running tests"
# Continue session
droid exec -s <session-id> "continue previous task"
droid exec -s <session-id> --model custom:Kimi-K2.5 "continue previous task"
```