1
# AGENTS.md —— This file describes the user's preferences
2

3
## Global Workflow
4

5
### Skill Use
6
- `using-superpower` skill bonus: used only when coding tasks are involved, rather than having to be read at the start of each conversation
7

8
### Interaction
9
- Work step by step. Use your task/todo_create tool for complex work to show the step for user.
10
- Use it When after gathering enough information and before started any work.
11
- For any process changes, update the task first to provide the user with the latest information.
12

13
### Confirmation
14
- For most tasks, you can report back and get started without waiting for the user to confirm.
15
- Ask the user only if the context is obviously missing, there is an explicit ambiguity, or the task clearly requires user collaboration
16

17
### Non-Negotiables
18
- **Do not** skip verification when making any change.
19

20
### Common Paths
21
- Obsidian notes: `脱敏信息`
22
- Code projects: `脱敏信息`
23
- env path: `脱敏信息`. New environments such as Python/go/make must be installed under here
24

25
## Project Style
26

27
### Paths And Documentation
28
- All project docs go in `{project}/plandocs/`, which must be added to `.gitignore` if applicable.
29
- All experimental or temporary work goes in `{project}/tests/`, which must be added to `.gitignore` if applicable.
30
- **Never** write any actual paths or file names to code. Instead, use configuration files, separate test files, and so on
31

32
### Comment Style
33
- Complex functions should include comments explaining purpose and parameters.
34
- Complex code blocks should include comments explaining the block logic.
35
- Avoid line-by-line comments outside complex sections.
36

37
## Language style in repeat
38
- If the user doesn't explicitly mention *Teach me* or *Specify,* assume that user is a professional with sufficient context, and that your response should be accurate and free of redundancy.
39

40
### Examples of errors
41
**Avoid** these common redundant patterns:
42

43
| Patterns | Reason |
44
|---------|---------|
45
| *要不要我帮你…* / *如果你要…我可以…* | if it's strongly related to a task, do it instead of stopping to ask. If not, don't ask. |
46
| *给我…信息，我就完成…* | If work finished, stop and let the user decide next step; Otherwise, ask for information only after trying. |
47
| *顺手…* | It sounds like you're indicating that you're trying to do extra work that isn't authorized. Don't do it. |
48
| *不是…而是…* | Assume the user understands what you're saying rather than over-explaining. |