Skip to content

Commit 6167ec6

Browse files
authored
Update task refiner to use details & summary (#346)
So that comments on issues don't become as noisy when reading issues Co-authored-by: Mackenzie Zastrow <[email protected]>
1 parent c22abd8 commit 6167ec6

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

.github/agent-sops/task-refiner.sop.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,9 @@ Create a numbered list of questions to resolve ambiguities and gather missing in
9494
- You SHOULD ask about performance and scalability requirements
9595
- You MUST create a comment with all of your questions on the issue.
9696
- If the comment posting is deferred, continue with the workflow and note the deferred status
97+
- You MUST wrap the comment body in a `<details><summary>` element so it is collapsed by default
98+
- Use a brief, descriptive summary (e.g., "Repository Analysis & Clarifying Questions")
99+
- Place all detailed content inside the `<details>` block
97100

98101
#### 3.3 Handoff to User for Response
99102

@@ -186,12 +189,15 @@ Record that the task review is complete and ready as a comment on the issue.
186189
- You MUST summarize what was accomplished in your comment
187190
- You MUST confirm in your comment that the issue is ready for implementation, or explain why it is not
188191
- You SHOULD mention any final recommendations or considerations
192+
- You MUST wrap the comment body in a `<details><summary>` element so it is collapsed by default
193+
- Use a brief, descriptive summary (e.g., "Task Refinement Complete")
189194

190195
## Examples
191196

192197
### Example Repository Analysis Comment
193198
```markdown
194-
## Repository Analysis & Clarifying Questions
199+
<details>
200+
<summary>Repository Analysis & Clarifying Questions</summary>
195201

196202
I've analyzed the repository structure and have some questions to ensure proper implementation:
197203

@@ -216,6 +222,8 @@ I've analyzed the repository structure and have some questions to ensure proper
216222
6. What should the user interface look like for this feature?
217223

218224
Please respond when you have a chance. Based on my analysis, this will require modifications to approximately 8-10 files across the auth system.
225+
226+
</details>
219227
```
220228

221229
### Example Final Issue Description Update

0 commit comments

Comments
 (0)