docs-human

仓库创建 2026年7月2日最近提交 21 天前SkillHot 收录 20 天前

▸ 精选理由

把机器文档转换成易读的决策、状态和架构文档，便于沟通汇报。

这个 Skill 做什么

定义供人类快速浏览的项目文档格式与产出规范。

把项目文档写成人能快速看懂的格式：简洁语言、清晰标题和要点优先，常见文件包括 DECISIONS.md、STATUS.md、ARCHITECTURE.md。在为利益相关方编写或更新文档时用，目的是让人快速扫到关键决策和上下文。特点是从机器文档和代码抽取要点并重写成易读版本。

▸ 展开 SKILL.md 英文原文

Human-readable documentation standard — scannable, plain-language docs derived from the agent docs but formatted for human consumption. Defines the project's human-doc file set and format rules. Use when creating or updating documentation intended for human stakeholders.

内容创作人类文档可读性格式化通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/dustinkeeton/wafflestack/main/.claude/skills/docs-human/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/dustinkeeton/wafflestack/main/.claude/skills/docs-human/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

# Human Documentation

## Purpose

Produce documentation that humans can quickly scan to understand the project. The human docs for this project are `DECISIONS.md`, `STATUS.md`, and `ARCHITECTURE.md` at the repo root. Derive from the machine docs and the codebase, but reformat for human readers — plain language, headings, and bullets over walls of prose.

Prioritize:

- **Decision log** — what was decided, why, and what alternatives were considered
- **Status visibility** — what's done, what's in progress, what's blocked
- **Change history** — what changed and why, in reverse chronological order (newest on top)
- **Plain language** — avoid jargon where possible, explain technical terms

## D

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有