Просмотр исходного кода

docs(skill): clarify comment guidance

Tianyi Cui 2 месяцев назад
Родитель
Сommit
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