人和 AI 可读的技术文档

原名：hads

用明确标签区分规范、背景、已知问题和待核实内容，保留版本与阅读顺序。

中文 Skills 技能说明

公司技术说明混着事实、想法和旧故障时，可让技术文档工程师整理。提供原文、版本、已确认事实和待决问题，技能按 HADS 约定组织 Markdown，交付文档草稿和格式检查。HADS 是上游文档约定，不宣称国家标准或搜索引擎强制要求，也不会自动改变平台文档体系。方法可本地阅读，无需专用服务；迁移前保留原文，未验证的内容必须标注，不能把设想提升成规范，涉及公司内部信息的公开与覆盖先由负责人确认。

上游能力依据

上游原始适用说明：Use when writing technical documentation that needs to be readable by both humans and AI models, converting existing docs to HADS format, validating a HADS document, or optimizing documentation for token-efficient AI consumption.

上游 SKILL.md 主要章节（保留原文标题）：

• AI READING INSTRUCTION
• 1. WHAT IS HADS
• 2. BLOCK TYPES
• 3. REQUIRED DOCUMENT STRUCTURE
• 1. First Section
• 4. HOW CLAUDE READS HADS
• 5. HOW CLAUDE GENERATES HADS
• 6. VALIDATION RULES
• 7. EXAMPLE INTERACTIONS
• 8. DESIGN INTENT

使用边界

先提供真实业务背景、目标受众和可核验资料。输出是工作草稿或决策辅助，不补造客户反馈、经营数据、案例或引用。

作者、翻译与许可证

原作者

Seth Hobson（wshobson）与 agents contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/wshobson/agents/tree/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-standards/skills/hads

适用范围

平台：linux、macos、windows；标签：效率与知识、人和 AI 可读的技术文档、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。