一键在 Manus 中运行任何 Skill

hads

星标1

分支1

更新时间2026年5月20日 09:22

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

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

在 Manus 中运行

来源

gaoqiongxie

gaoqiongxie/skills-ai

打开 GitHub 仓库查看创作者相关仓库

下载

在 Manus 中运行

📋 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 都能一次读懂。"

同仓库更多 Skills

同仓库

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 都能一次读懂。"