47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# Cross-Platform AI Usage
|
|
|
|
## Agents.md
|
|
### What It Is
|
|
Agents define a structured workflow so tasks are broken into clear steps, with explicit inputs and outputs.
|
|
|
|
### How to Use It
|
|
1. Read [Agents.md](../../Agents.md).
|
|
2. Choose a workflow that matches your task.
|
|
3. Provide the inputs in a short, bounded request.
|
|
|
|
### When to Use Agents vs Chat
|
|
- Use agents for multi-step tasks like refactors, doc audits, or migrations.
|
|
- Use chat for quick questions or one-off explanations.
|
|
|
|
### Request Template
|
|
Use this structure to get consistent results:
|
|
|
|
```text
|
|
Goal: <one sentence>
|
|
Inputs: <files, constraints, context>
|
|
Output: <expected deliverable>
|
|
Verification: <tests or checks>
|
|
```
|
|
|
|
## Prompting Patterns
|
|
- Refactors: "Refactor this file to improve readability without changing behavior."
|
|
- Tests: "Add unit tests for this service. Keep the existing public API."
|
|
- Debugging: "Explain this error and list likely fixes in order."
|
|
- Understanding code: "Summarize what this module does and call out risks."
|
|
|
|
## Plan-First Workflow
|
|
1. Ask for a short plan.
|
|
2. Approve or adjust the plan.
|
|
3. Ask for targeted changes.
|
|
4. Verify with tests or review.
|
|
|
|
## Connecting Skills
|
|
- Use skills for tasks with known workflows.
|
|
- Combine multiple skills when a task spans domains.
|
|
- Pass concise context between steps to reduce repetition.
|
|
|
|
## Efficiency Tips
|
|
- Keep prompts small and scoped.
|
|
- Reuse context from earlier steps instead of repeating it.
|
|
- Ask for summaries before asking for edits.
|