Run any Skill in Manus with one click

hads

Stars1

Forks1

UpdatedMay 20, 2026 at 09:22

人-AI双读文档标准（Human-AI Document Standard）：一套轻量级Markdown约定，让文档同时服务于人类读者和AI理解。当用户说'双读文档'、'人机共读'、'AI友好的文档'、'文档标准'、'HADS'、'AI文档规范'、'结构化文档'时触发。核心特点：语义标记、AI解析友好、人类可读、版本兼容。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

gaoqiongxie

gaoqiongxie/skills-ai

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Secretaries and Administrative Assistants, Except Legal, Medical, and ExecutiveOffice and Administrative Support Occupations·SOC 43-6014

SKILL.md

readonly

name	hads
description	人-AI双读文档标准（Human-AI Document Standard）：一套轻量级Markdown约定，让文档同时服务于人类读者和AI理解。当用户说'双读文档'、'人机共读'、'AI友好的文档'、'文档标准'、'HADS'、'AI文档规范'、'结构化文档'时触发。核心特点：语义标记、AI解析友好、人类可读、版本兼容。

来源: Anthropic Skills PR #616 (Human-AI Document Standard)

发布时间: 2026-05

理念: "写一份文档，服务两种读者——人类和 AI。"

📋 HADS — Human-AI Document Standard

人-AI 双读文档标准：让 Markdown 同时服务于人类理解和 AI 解析。

🎯 核心概念

传统文档的困境：

人类看得懂，AI 理解偏
AI 解析准，人类阅读累

HADS 的解决方案：

语义标记 — 用轻量约定传达结构含义
双重兼容 — 不破坏人类阅读体验，增强 AI 解析精度
渐进增强 — 按需添加 AI 提示，不强制全套使用

📝 HADS 标记规范

1. 文档元信息（YAML Frontmatter）

---
title: "用户认证模块设计"
author: "张三"
date: 2026-05-09
version: "1.2"
hads-version: "1.0"
type: "design-doc"        # design-doc | api-spec | prd | adr
topics: [auth, security, jwt]
audience: [developer, ai]
---

2. 语义标题标记

# [DESIGN] 认证模块架构设计
## [CONTEXT] 背景与现状
## [DECISION] 架构决策
### [OPTION-A] 方案一：Session + Cookie
### [OPTION-B] 方案二：JWT + Refresh Token  ⭐ SELECTED
## [RATIONALE] 决策理由
## [IMPLICATION] 影响与风险
## [TODO] 待办事项

3. AI 提示块

<!-- AI-NOTE: 这是核心决策，后续讨论不要偏离 -->
<!-- AI-CONTEXT: 见 docs/architecture/auth-v1.md 第 3 节 -->
<!-- AI-TODO: 需要补充性能测试数据 -->
<!-- AI-WARNING: 此方案在分布式环境下有已知问题 -->

4. 结构化表格

| 属性 | 值 | [AI-TYPE] |
|------|-----|-----------|
| 接口路径 | /api/v1/auth/login | string |
| 方法 | POST | enum:GET,POST,PUT,DELETE |
| 认证要求 | 否 | boolean |
| 限流 | 100/min | rate-limit |

5. 决策记录（ADR 精简版）

## [ADR-001] 使用 JWT 替代 Session

- **状态**: ✅ ACCEPTED
- **日期**: 2026-05-01
- **决策者**: @张三, @李四

### 上下文
<!-- AI-SUMMARY: 单体应用迁移到微服务，Session 共享成本高 -->

### 决策
采用 JWT + Redis 刷新令牌方案。

### 后果
- ✅ 无状态，易于水平扩展
- ✅ 跨服务认证简单
- ⚠️ Token 吊销需要额外机制
- ❌ Token 体积大于 Session ID

🆚 与普通 Markdown 的区别

场景	普通 Markdown	HADS
标题	`# 背景`	`## [CONTEXT] 背景`
注释	HTML 注释不可见	`<!-- AI-NOTE: -->` AI 可见
表格	纯展示	加 `[AI-TYPE]` 标注数据类型
决策	分散在段落中	`[DECISION]` + `[RATIONALE]` 结构化

🚀 使用方式

方式一：转换现有文档

把这份普通 Markdown 转成 HADS 格式

方式二：创建新文档

用 HADS 标准写一份 API 设计文档

方式三：审查文档兼容性

检查这份文档是否符合 HADS 标准，AI 能否准确解析

💡 最佳实践

DO

✅ 在团队文档中渐进引入 HADS 标记
✅ 关键决策使用 [DECISION] + [RATIONALE]
✅ 用  标注容易误解的地方
✅ 保持标记简洁，不牺牲人类可读性

DON'T

❌ 每个标题都加语义标记（过度工程）
❌ 用 HADS 替代清晰的自然语言
❌ 在对外文档中使用内部 AI 标记

🔗 与其他 Skill 的关系

	HADS	openspec-sdd	prd-to-demo
用途	文档格式标准	需求规范流程	原型生成
最佳组合	openspec-sdd 输出规范 → HADS 格式化 → prd-to-demo 生成原型

"好的文档标准，让人类和 AI 都能一次读懂。"

More from this repository

same repository

enterprise-iteration-agent

gaoqiongxie/skills-ai

企业级全栈迭代工作流Agent：当用户说'开始开发这个需求'、'处理本次迭代'、'全栈开发闭环'、'跑一个迭代'、'enterprise iteration'、'迭代开发'、'需求交付'、'开发闭环'时触发。自动按需求→设计→开发→测试→Review→部署→记忆7阶段推进，维护迭代状态机，路径感知（自动读取需求目录与代码目录），协调多个子Skill协作完成企业级CRM全栈需求交付。支持状态回退、并行分支、上下文继承。

2026-06-041

enterprise-crm-fullstack

gaoqiongxie/skills-ai

企业级CRM全栈开发规范：基于Vue 2 + Element UI + Java Spring Boot的标准化开发指南。覆盖前端配置式列表页、详情页、国际化、权限控制，后端分层架构、接口规范、数据库设计。当用户说'CRM开发'、'Vue 2列表页'、'Element UI表单'、'Java后端接口'、'全栈开发规范'、'中后台系统开发'、'工单系统开发'、'客户管理系统开发'时触发。核心特点：前后端标准化、配置式开发、企业级权限、国际化支持。

2026-06-041

cybersecurity-skills

gaoqiongxie/skills-ai

网络安全分析师技能库：754个结构化安全技能，让AI具备Senior Analyst级别的全栈安全分析能力。覆盖威胁狩猎、数字取证、事件响应、渗透测试、代码安全审计、威胁情报、恶意软件分析等26个安全领域。映射MITRE ATT&CK v19.1、NIST CSF 2.0、MITRE ATLAS v5.4、MITRE D3FEND v1.3、NIST AI RMF 1.0五大框架。当用户说'安全分析'、'威胁狩猎'、'威胁情报'、'渗透测试'、'事件响应'、'MITRE'、'代码审计'、'数字取证'、'恶意软件分析'、'红队'、'蓝队'、'SOC'、'漏洞分析'、'安全运营'、'网络攻防'、'入侵检测'时触发。渐进式加载设计，500-2000 tokens完整加载，避免上下文溢出。

2026-06-041

taste-skill

gaoqiongxie/skills-ai

反平庸 UI 设计 Skill：让 AI 生成的前端界面摆脱样板化、去AI味，提升布局、排版、动效和间距品质。当用户说'反平庸设计'、'去AI味UI'、'提升界面品质'、'设计系统'、'UI太模板化'、'界面不够精致'、'去掉AI生成的UI感'、'让页面更有设计感'时触发。核心特点：框架无关的设计规则、三档参数调节（DESIGN_VARIANCE/MOTION_INTENSITY/VISUAL_DENSITY）、anti-slop 反重复机制、8大设计方向体系。

2026-06-041

algorithmic-art

gaoqiongxie/skills-ai

算法艺术生成器：用p5.js/Canvas代码生成程序化艺术作品，包括粒子系统、几何图形、种子随机、噪声纹理、动态壁纸。当用户说'生成艺术'、'算法壁纸'、'p5.js艺术'、'代码画画'、'生成海报'、'粒子效果'、'噪声纹理'、'程序化艺术'时触发。核心特点：种子可控复现、参数化设计、数学美学、代码即画布。

2026-05-291

cloudflare-worker

gaoqiongxie/skills-ai

Cloudflare Worker边缘函数构建指南：用Wrangler CLI开发、调试、部署Serverless函数，实现轻量API/边缘缓存/中间层/反向代理。当用户说'写个Worker'、'边缘函数'、'Cloudflare部署'、'Serverless API'、'轻量后端'、'边缘计算'、'CF Worker'时触发。核心特点：Wrangler工作流、边缘环境特性、KV/DO/R2存储、TypeScript最佳实践、本地调试到部署全链路。

2026-05-291

name	hads
description	人-AI双读文档标准（Human-AI Document Standard）：一套轻量级Markdown约定，让文档同时服务于人类读者和AI理解。当用户说'双读文档'、'人机共读'、'AI友好的文档'、'文档标准'、'HADS'、'AI文档规范'、'结构化文档'时触发。核心特点：语义标记、AI解析友好、人类可读、版本兼容。

来源: Anthropic Skills PR #616 (Human-AI Document Standard)

发布时间: 2026-05

理念: "写一份文档，服务两种读者——人类和 AI。"

📋 HADS — Human-AI Document Standard

人-AI 双读文档标准：让 Markdown 同时服务于人类理解和 AI 解析。

🎯 核心概念

传统文档的困境：

人类看得懂，AI 理解偏
AI 解析准，人类阅读累

HADS 的解决方案：

语义标记 — 用轻量约定传达结构含义
双重兼容 — 不破坏人类阅读体验，增强 AI 解析精度
渐进增强 — 按需添加 AI 提示，不强制全套使用

📝 HADS 标记规范

1. 文档元信息（YAML Frontmatter）

---
title: "用户认证模块设计"
author: "张三"
date: 2026-05-09
version: "1.2"
hads-version: "1.0"
type: "design-doc"        # design-doc | api-spec | prd | adr
topics: [auth, security, jwt]
audience: [developer, ai]
---

2. 语义标题标记

# [DESIGN] 认证模块架构设计
## [CONTEXT] 背景与现状
## [DECISION] 架构决策
### [OPTION-A] 方案一：Session + Cookie
### [OPTION-B] 方案二：JWT + Refresh Token  ⭐ SELECTED
## [RATIONALE] 决策理由
## [IMPLICATION] 影响与风险
## [TODO] 待办事项

3. AI 提示块

<!-- AI-NOTE: 这是核心决策，后续讨论不要偏离 -->
<!-- AI-CONTEXT: 见 docs/architecture/auth-v1.md 第 3 节 -->
<!-- AI-TODO: 需要补充性能测试数据 -->
<!-- AI-WARNING: 此方案在分布式环境下有已知问题 -->

4. 结构化表格

| 属性 | 值 | [AI-TYPE] |
|------|-----|-----------|
| 接口路径 | /api/v1/auth/login | string |
| 方法 | POST | enum:GET,POST,PUT,DELETE |
| 认证要求 | 否 | boolean |
| 限流 | 100/min | rate-limit |

5. 决策记录（ADR 精简版）

## [ADR-001] 使用 JWT 替代 Session

- **状态**: ✅ ACCEPTED
- **日期**: 2026-05-01
- **决策者**: @张三, @李四

### 上下文
<!-- AI-SUMMARY: 单体应用迁移到微服务，Session 共享成本高 -->

### 决策
采用 JWT + Redis 刷新令牌方案。

### 后果
- ✅ 无状态，易于水平扩展
- ✅ 跨服务认证简单
- ⚠️ Token 吊销需要额外机制
- ❌ Token 体积大于 Session ID

🆚 与普通 Markdown 的区别

场景	普通 Markdown	HADS
标题	`# 背景`	`## [CONTEXT] 背景`
注释	HTML 注释不可见	`<!-- AI-NOTE: -->` AI 可见
表格	纯展示	加 `[AI-TYPE]` 标注数据类型
决策	分散在段落中	`[DECISION]` + `[RATIONALE]` 结构化

🚀 使用方式

方式一：转换现有文档

把这份普通 Markdown 转成 HADS 格式

方式二：创建新文档

用 HADS 标准写一份 API 设计文档

方式三：审查文档兼容性

检查这份文档是否符合 HADS 标准，AI 能否准确解析

💡 最佳实践

DO

✅ 在团队文档中渐进引入 HADS 标记
✅ 关键决策使用 [DECISION] + [RATIONALE]
✅ 用  标注容易误解的地方
✅ 保持标记简洁，不牺牲人类可读性

DON'T

❌ 每个标题都加语义标记（过度工程）
❌ 用 HADS 替代清晰的自然语言
❌ 在对外文档中使用内部 AI 标记

🔗 与其他 Skill 的关系

	HADS	openspec-sdd	prd-to-demo
用途	文档格式标准	需求规范流程	原型生成
最佳组合	openspec-sdd 输出规范 → HADS 格式化 → prd-to-demo 生成原型

"好的文档标准，让人类和 AI 都能一次读懂。"