AGENT SKILL

pstack-no-comments

Review comments and encode verified constraints within the authorized scope.

License 许可
MIT
最近更新
2026-11-13
Stars
★ 0
Forks
0

01 前言 Front Matter

name
pstack-no-comments
description
Review comments and encode verified constraints within the authorized scope.

02 资源文件 2

03 SKILL.md 正文

No comments

Review comments for information the code cannot express. Use the caller's scope, or the current diff against its base branch, including the working tree.

Use an existing read-only FirstMate or harness delegate when an independent review helps. Pass comment-reviewer.md and the scope, using the configured model and effort. Without delegation, perform a separate review pass yourself. No specialized agent or plugin is required.

  1. Inspect each proposed deletion against nearby code and the reviewer's evidence. Reject scope escapes, application-code edits, and unsupported findings.
  2. Keep legal headers, public API contracts, verified external constraints, and explanations of behavior that remains non-obvious. If a constraint cannot be verified, preserve it and report the gap.
  3. Remove narration, obsolete commented-out code, and redundant explanations within the authorized scope. Do not erase a safety or correctness suppression until its underlying defect is fixed and verified.
  4. Fix accepted trivial causes directly, such as a dead path or a misleading name. If a structural change is needed, use the architect guide. Keep fixes inside the caller's scope.
  5. Replace a necessary constraint comment with a type, test, or lint only when that mechanism preserves the constraint and the change is authorized. Otherwise keep the comment. Do not require an extra approval for routine authorized edits.
  6. Report accepted changes, preserved constraints, verified fixes, and open findings. Cite the affected symbol and evidence.

Use how and why when a comment's claim needs investigation. The fix-root-causes and redesign-from-first-principles guides do not authorize wider changes.

04 同仓库更多 Skills