소스 검색

docs(skill): clarify comment guidance

Tianyi Cui 2 달 전
부모
커밋
adedeb70a8
1개의 변경된 파일과 1개의 추가작업 그리고 1개의 파일을 삭제
  1. 1 1
      .agents/skills/dsh-prose-standard/SKILL.md

+ 1 - 1
.agents/skills/dsh-prose-standard/SKILL.md

@@ -7,7 +7,7 @@ description: Use when writing, reviewing, restoring, trimming, or auditing prose
 
 Write enough to preserve the contract, then remove reasoning transcripts, repetition, and decoration. This skill owns editorial judgment and required prose coverage; use [dsh-doc-standards](../dsh-doc-standards/SKILL.md) for placement, budgets, bilingual pairs, and documentation gates. It is guidance, not a script.
 
-comment should only describe what is not obvious in the code or not implied by the code.
+Comments describe non-obvious contracts or rationale that code cannot express; they do not restate what code already implies.
 
 ## Inputs and exclusions