Skill: pipiy416/guild-knowledge (version 1.0.1)

--- name: guild-knowledge description: Guild 经验文档管理技能。核心原则：经验是参考，不是圣经。自动查阅 Guild 文档 + 搜索最新信息 + 对比评估。| Guild experience document management skill. Core principle: Experience is a reference, not scripture. Auto-reads Guild docs + searches latest info + compares and evaluates. version: 1.0.1 license: MIT languages: [zh-CN, en] author: Pipiy416 homepage: https://github.com/Pipiy416/guild-knowledge tags: [经验管理，文档，知识管理，Guild, experience-management, documentation, knowledge-base, best-practices] auto_trigger: true trigger: keyword_zh: 搭建网站 | 创建网站 | 清理工作区 | 删除文件 | 整理文件 | 技术审查 | 新技术 | 技术雷达 | Guild | 经验文档 | 经验文件 keyword_en: build website | create website | cleanup workspace | delete files | organize files | technology review | new technology | tech radar | Guild | experience docs | experience documents --- # Guild Knowledge Skill / Guild 经验文档管理 **版本 (Version):** 1.0.1 **创建日期 (Created):** YYYY-MM-DD **核心原则 (Core Principle):** 经验是参考，不是圣经 | Experience is a reference, not scripture --- ## 📜 核心原则 / Core Principle ``` "经验是参考，不是圣经" Experience is a reference, not scripture. ``` ### 强制流程 / Mandatory Workflow ``` 1. 读取 Guild 文档 / Read Guild document ↓ 2. 搜索最新信息（强制！）/ Search latest info (MANDATORY!) - 技术最新版本 / Latest technology versions - 替代方案 / Alternative solutions - 最佳实践 / Best practices ↓ 3. 对比评估 / Compare & Evaluate - Guild 建议 vs 最新方案 / Guild vs Latest ↓ 4. 决策 / Decision - Guild 仍最优 → 采用 Guild - 新方案更好 → 建议更新 - 不确定 → 询问用户 ↓ 5. 应用 + 提醒 / Apply + Remind ``` ### 禁止行为 / Forbidden Actions ``` ❌ 盲从 Guild 经验，不搜索最新信息 ❌ 使用过时的技术/工具 ❌ 发现更好的方法不更新文档 ❌ 未经用户审批修改 Guild 文档 ``` --- ## 🎯 自动触发 / Auto-Trigger ### 触发词示例 / Example Trigger Keywords | 中文触发词 | English Trigger | 说明 / Description | |-----------|----------------|-------------------| | 搭建网站 | build website | 网站搭建相关任务 | | 清理工作区 | cleanup workspace | 工作区整理相关 | | 技术审查 | technology review | 技术评估相关 | | Guild | Guild | 文档管理相关 | **注意**: 用户可以根据自己的 Guild 文档自定义触发词。 **Note**: Users can customize trigger keywords based on their own Guild documents. --- ## 📋 功能列表 / Features ### 功能 1：自动查阅 + 搜索 / Auto-Read + Search ```yaml 触发：用户提到相关任务 动作: 1. 自动读取对应 Guild 文档 2. 搜索最新信息 3. 对比评估 4. 给出建议 5. 提醒是否更新文档 ``` --- ### 功能 2：文档检索 / Document Retrieval ```yaml 命令: /guild list # 列出所有 Guild 文档 /guild search <关键词> # 搜索经验文档 /guild review # 触发审查 ``` --- ### 功能 3：分级审查 / Tiered Review ```yaml 审查策略: 📊 技术类文档：每月审查 📚 经验类文档：3 个月审查 📖 规范类文档：6 个月审查 审批模式：所有修改需用户审批 ``` --- ### 功能 4：索引更新 / Index Update ```yaml 流程: 扫描 Guild/文件夹 ↓ 检测新文件/内容变更 ↓ 生成更新建议 ↓ 用户审批 → 更新索引 ``` --- ### 功能 5：经验提取 / Experience Extraction ```yaml 筛选标准: ✅ 重复出现≥3 次 ✅ 跨项目/跨场景适用 ✅ 有明确解决方案 流程: 审查学习记录 ↓ 识别高质量经验 ↓ 建议创建 Guild 文档 ↓ 用户审批 → 创建文档 ``` --- ### 功能 6：版本管理 / Version Management ```yaml 文档头部格式: --- guild_version: 1.0 created: YYYY-MM-DD updated: YYYY-MM-DD author: [作者名] review_cycle: 6months --- ``` --- ## 📖 使用示例 / Usage Examples ### 示例 1：技术选型 / Example 1: Technology Selection ``` 用户：帮我搭建一个网站 Guild Knowledge: 1. ✅ 读取相关 Guild 经验文档 2. ✅ 搜索最新技术栈和框架 3. ✅ 对比 Guild 建议 vs 最新方案 4. ✅ 回复: "根据 Guild 经验 + 最新搜索，推荐： - 技术栈：[根据需求推荐] - 框架：[现代框架] 需要我开始实施吗？" ``` --- ### 示例 2：发现新工具 / Example 2: Discovering New Tools ``` Guild Knowledge 发现: - Guild 建议：[原有方案] - 最新搜索：[新工具] 有更新 回复: "Guild 经验推荐使用 [原有方案]。 但最新搜索发现：[新工具] 已更新 对比: - 原有方案：[优点/缺点] - 新方案：[优点/缺点] 建议：测试后决定是否更新 Guild 文档。 需要我测试吗？" ``` --- ### 示例 3：月度审查 / Example 3: Monthly Review ``` 时间：每月 1 号 09:00 生成报告: "📊 Guild 月度审查报告 - [年月] ✅ 无需更新: - [领域 A]：Guild 建议 [版本]，最新 [版本] ⚠️ 建议更新: - [工具/技术]：发现新版本 建议：[具体建议] 请审批: - 回复"批准" → 应用修改 - 回复"跳过" → 本次不修改" ``` --- ## 🔒 安全限制 / Safety Constraints ```yaml 修改限制: - 所有 Guild 文档修改 → 必须用户审批 - 不能删除 Guild 文件 - 不能移动 Guild 文件出 Guild/文件夹 审批模式: - 所有修改都需审批（无论大小） ``` --- ## 📁 文件结构示例 / Example File Structure ``` Guild/ ├── README.md # Guild 文件夹说明 ├── INDEX.md # 文档索引 ├── .guild_manifest.json # 机器可读清单 ├── Guild_[主题 1].md # 经验文档 1 ├── Guild_[主题 2].md # 经验文档 2 └── Guild_[主题 3].md # 经验文档 3 .learnings/ ├── LEARNINGS.md # 学习记录 ├── ERRORS.md # 错误记录 └── FEATURE_REQUESTS.md # 功能请求 ``` **注意**: 用户根据自己的项目创建 Guild 文档，以上仅为示例结构。 **Note**: Users create Guild documents based on their own projects. Above is example structure only. --- ## 🔄 与其他技能协作 / Integrations 本技能可独立工作，也可与其他技能协作： **This skill works independently but can integrate with other skills:** | 协作场景 / Integration | 说明 / Description | |----------------------|-------------------| | 学习记录 / Learning Capture | 从对话中提取经验 / Extract experience | | 文档审查 / Document Review | 定期审查文档 / Periodic review | | 经验推广 / Experience Sharing | 发布到 ClawHub / Share to ClawHub | **注意**: 所有集成都是可选的。 **Note**: All integrations are optional. --- ## 📊 审查周期示例 / Example Review Cycles | 文档类型 / Document Type | 周期 / Cycle | 内容 / Content | |---------|---------|---------| | 技术雷达 / Tech Radar | 每月 / Monthly | 技术更新 / Tech updates | | 项目经验 / Project Experience | 6 个月 | 技术栈更新 / Stack updates | | 安全规范 / Security Guidelines | 3 个月 | 最佳实践 / Best practices | **注意**: 用户自定义审查周期。 **Note**: Users define their own review cycles. --- ## 📝 版本历史 / Version History ``` [YYYY-MM-DD] v1.0.1 - 更新 / Update - 添加中英文双语支持 - 优化文件结构 - 改进文档说明 - Author: Pipiy416 [YYYY-MM-DD] v1.0.0 - 初始创建 / Initial Release - 创建 Guild Knowledge Skill - 核心原则："经验是参考，不是圣经" - 实现自动查阅 + 最新信息搜索 ``` --- *经验是参考，不是圣经。保持开放，拥抱变化，用更好的方法！* *Experience is a reference, not scripture. Stay adaptable, embrace change, use better methods!*

path: README.md
content: # Guild Knowledge Skill / Guild 经验文档管理

[![Version](https://img.shields.io/badge/version-1.0.1-blue.svg)](https://clawhub.com/skills/guild-knowledge)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-OpenClaw-orange.svg)](https://openclaw.ai)

**🌏 English | 🇨🇳 中文**

---

## 📖 Overview / 概述

**Guild Knowledge** is an experience document management skill for OpenClaw agents. It helps AI agents learn from past experiences while staying adaptable to new methods and technologies.

**Guild Knowledge** 是 OpenClaw 智能体的经验文档管理技能。它帮助 AI 智能体从过去的经验中学习，同时保持对新方法和技术的适应性。

**Core Principle / 核心原则:**
> "Experience is a reference, not scripture."
> "经验是参考，不是圣经。"

---

## ✨ Features / 功能特性

| Feature / 功能 | Description / 说明 |
|---------------|-------------------|
| 📚 **Auto-Read Guild Docs** / 自动查阅 Guild 文档 | Automatically reads relevant experience documents before tasks / 执行任务前自动阅读相关经验文档 |
| 🔍 **Search Latest Info** / 搜索最新信息 | Mandatory search for latest technologies and best practices / 强制搜索最新技术和最佳实践 |
| ⚖️ **Compare & Evaluate** / 对比评估 | Compares Guild recommendations vs. latest solutions / 对比 Guild 建议与最新方案 |
| 📅 **Monthly Review** / 月度审查 | Scheduled review of experience documents to prevent obsolescence / 定期审查经验文档避免过时 |
| 💡 **Experience Extraction** / 经验提取 | Automatically identifies patterns worth documenting / 自动识别值得记录的经验模式 |
| 📝 **Version Management** / 版本管理 | Tracks document versions and review cycles / 追踪文档版本和审查周期 |

---

## 🚀 Quick Start / 快速开始

### Installation / 安装

```bash
clawhub install guild-knowledge
```

### Automatic Trigger / 自动触发

The skill auto-triggers when you mention these keywords:

当提到以下关键词时自动触发：

| Chinese / 中文 | English / 英文 |
|---------------|---------------|
| 搭建网站 | build website |
| 清理工作区 | cleanup workspace |
| 技术审查 | technology review |
| Guild / 经验文档 | Guild / experience docs |
| PHP 网站 | PHP website |
| 删除文件 | delete files |

### Manual Trigger / 手动触发

```
/guild list        # List all Guild documents / 列出所有 Guild 文档
/guild search <query>  # Search experience documents / 搜索经验文档
/guild review      # Trigger monthly review / 触发月度审查
```

---

## 📋 How It Works / 工作原理

### Mandatory Workflow / 强制流程

```
┌─────────────────────────────────────────────────────────────┐
│  1. Read Guild Documents / 读取 Guild 文档                   │
│         ↓                                                    │
│  2. Search Latest Info (MANDATORY!) / 搜索最新信息（强制！） │
│     - Latest versions / 最新版本                             │
│     - Alternatives / 替代方案                                │
│     - Best practices / 最佳实践                              │
│         ↓                                                    │
│  3. Compare & Evaluate / 对比评估                            │
│     - Guild vs. Latest / Guild vs 最新                       │
│         ↓                                                    │
│  4. Decision / 决策                                          │
│     - Guild still best → Use Guild / Guild 仍最优→采用 Guild  │
│     - Better alternative → Suggest update / 有新方案→建议更新 │
│     - Uncertain → Ask user / 不确定→询问用户                 │
│         ↓                                                    │
│  5. Apply + Remind / 应用 + 提醒                             │
│     "Based on Guild + latest research, recommend XXX"        │
│     "根据 Guild 经验 + 最新搜索，推荐 XXX"                      │
└─────────────────────────────────────────────────────────────┘
```

---

## 📁 Document Structure / 文档结构

### Example Guild Documents / Guild 文档示例

| Document / 文档 | Purpose / 用途 | Review Cycle / 审查周期 |
|----------------|----------------|------------------------|
| `Guild_website-build-experience.md` | Website building best practices / 网站搭建最佳实践 | 6 months |
| `Guild_cleanup-guide.md` | Workspace organization guide / 工作区整理指南 | 6 months |
| `Guild_tech-radar.md` | Technology monitoring / 技术监控 | Monthly |
| `Guild_security-deployment.md` | Security deployment practices / 安全部署实践 | 3 months |

**Note**: Users create their own Guild documents based on their projects and experiences.

**注意**: 用户根据自己的项目和经验创建 Guild 文档。

### Protected Files / 受保护文件

Files with `Guild_` prefix are protected and should not be deleted manually.

`Guild_` 前缀的文件受保护，不应手动删除。

---

## 🎯 Use Cases / 使用场景

### Scenario 1: Building a Website / 搭建网站

```
User: "Help me build a website"
用户："帮我搭建一个网站"

Guild Knowledge:
1. ✅ Reads relevant Guild experience document
2. ✅ Searches latest technologies and frameworks
3. ✅ Compares Guild recommendations vs. latest solutions
4. ✅ Recommends: "Based on Guild experience + latest research, 
    recommend using [modern framework] for your use case"
    "根据 Guild 经验 + 最新搜索，推荐使用 [现代框架] 满足你的需求"
```

### Scenario 2: Technology Update / 技术更新

```
Guild Knowledge workflow:
1. Guild document suggests: "Use Technology A (v2.0)"
2. Latest search finds: "Technology A v3.0 released with 
   major improvements" or "Technology B is now recommended"

Response:
"Guild experience recommends Technology A v2.0.

However, latest research shows:
- Technology A v3.0 released with 50% performance improvement
- OR: Technology B is now the community recommended choice

Comparison provided. Would you like to:
1. Follow Guild experience (stable, proven)
2. Adopt latest recommendation (newer, may need testing)
3. Update Guild document after testing?"

"Guild 经验推荐使用 Technology A v2.0。

但最新搜索发现：
- Technology A v3.0 发布，性能提升 50%
- 或：Technology B 现在是社区推荐选择

已提供对比。你想：
1. 遵循 Guild 经验（稳定，已验证）
2. 采用最新推荐（较新，可能需要测试）
3. 测试后更新 Guild 文档？"
```

---

## 🔒 Safety Constraints / 安全限制

| Constraint / 限制 | Description / 说明 |
|------------------|-------------------|
| ❌ No blind following / 不盲从 | Never follow Guild without searching latest info / 不搜索最新信息就盲从 Guild |
| ❌ No outdated tech / 不使用过时技术 | Always prefer better alternatives / 优先选择更好的替代方案 |
| ❌ No auto-updates / 不自动更新 | All Guild changes require user approval / 所有 Guild 修改需用户审批 |
| ✅ Always verify / 始终验证 | Search before major tasks / 重大任务前搜索最新信息 |

---

## 📊 Review Cycle / 审查周期

| Document Type / 文档类型 | Cycle / 周期 | Content / 审查内容 |
|-------------------------|-------------|-------------------|
| Tech Radar / 技术雷达 | Monthly / 每月 | Tech updates, new tools / 技术更新、新工具 |
| Website Build / 网站搭建 | 6 months / 6 个月 | Web dev technologies / 网站开发技术 |
| Cleanup Guide / 清理指南 | 6 months / 6 个月 | Cleanup tools & methods / 清理工具和方法 |
| RPG Development / 游戏开发 | 6 months / 6 个月 | Game dev technologies / 游戏开发技术 |

---

## 🤝 Integration / 技能集成

### Optional Integrations / 可选集成

This skill works independently but can integrate with other OpenClaw skills:

本技能可独立工作，也可与其他 OpenClaw 技能集成：

| Integration / 集成 | Description / 说明 |
|-------------------|-------------------|
| **Experience Management** / 经验管理 | Auto-capture learnings from conversations / 自动捕获对话中的经验 |
| **Search Enhancement** / 搜索增强 | Use web search tools for latest info / 使用网络搜索获取最新信息 |
| **Document Automation** / 文档自动化 | Schedule periodic document reviews / 定期审查文档 |

**Note**: All integrations are optional and configurable.

**注意**: 所有集成都是可选和可配置的。

---

## 📝 Version History / 版本历史

### v1.0.1 (YYYY-MM-DD) - Update
- Bilingual support (Chinese + English)
- Optimized file structure
- Improved documentation

### v1.0.0 (YYYY-MM-DD) - Initial Release
- ✨ Initial release / 初始发布
- 📚 Auto-read Guild documents / 自动查阅 Guild 文档
- 🔍 Mandatory latest info search / 强制最新信息搜索
- ⚖️ Compare & evaluate workflow / 对比评估流程
- 📅 Monthly review system / 月度审查系统
- 💡 Experience extraction / 经验提取
- 📝 Version management / 版本管理

---

## 🎯 Best Practices / 最佳实践

### For Users / 给用户

1. ✅ **Review before tasks** - Check Guild docs before major tasks
   **任务前审查** - 重大任务前查阅 Guild 文档

2. ✅ **Stay open** - Experience is reference, not scripture
   **保持开放** - 经验是参考，不是圣经

3. ✅ **Approve changes** - Review and approve Guild updates
   **审批变更** - 审查并批准 Guild 更新

### For Agents / 给智能体

1. ✅ **Search first** - Always search latest info before using Guild
   **先搜索** - 使用 Guild 前始终搜索最新信息

2. ✅ **Compare honestly** - Admit when new methods are better
   **诚实对比** - 新方法更好时承认

3. ✅ **Document promptly** - Update Guild when better methods found
   **及时记录** - 发现更好方法时更新 Guild

---

## 📞 Support / 支持

- **Issues**: Open issue on ClawHub
- **Discussions**: clawhub.com/skills/guild-knowledge/discussions
- **Documentation**: See SKILL.md for detailed implementation

---

## 📄 License / 许可证

MIT License - Free to use, modify, and redistribute.

MIT 许可证 - 免费使用、修改和分发。

---

**Created by / 创建者**: Pipiy416  
**Last Updated / 最后更新**: 2026-03-27  
**Languages / 语言**: 🇨🇳 Chinese / 中文 + 🌏 English

---

*"Experience is a reference, not scripture. Stay adaptable, embrace change, use better methods!"*

*"经验是参考，不是圣经。保持开放，拥抱变化，用更好的方法！"*


path: _meta.json
content: {
  "ownerId": "kn72e4q61j807j4a90azhayc0d80wa2j",
  "slug": "guild-knowledge",
  "version": "1.0.1",
  "publishedAt": 1774271580000,
  "lastModified": 1774669200000,
  "modifiedBy": "Pipiy416",
  "author": "Pipiy416",
  "description": "Guild 经验文档管理技能。核心原则：经验是参考，不是圣经。| Guild experience document management skill. Core principle: Experience is a reference, not scripture.",
  "description_en": "Guild experience document management skill for OpenClaw. Core principle: Experience is a reference, not scripture. Auto-reads Guild docs, searches latest info, compares and evaluates.",
  "core_principle": "经验是参考，不是圣经 | Experience is a reference, not scripture",
  "license": "MIT",
  "homepage": "https://github.com/Pipiy416/guild-knowledge",
  "tags": [
    "经验管理",
    "文档",
    "知识管理",
    "Guild",
    "experience-management",
    "documentation",
    "knowledge-base",
    "best-practices"
  ],
  "languages": ["zh-CN", "en"],
  "features": [
    "自动查阅 Guild 文档 | Auto-read Guild documents",
    "搜索最新信息 | Search latest information",
    "对比评估 | Compare and evaluate",
    "月度审查 | Monthly review",
    "经验提取 | Experience extraction",
    "版本管理 | Version management"
  ],
  "review_cycle": "monthly",
  "approval_mode": "all_changes_require_approval",
  "auto_trigger": true,
  "trigger_keywords": {
    "zh": ["搭建网站", "创建网站", "PHP 网站", "清理工作区", "删除文件", "整理文件", "技术审查", "新技术", "技术雷达", "Guild", "经验文档", "经验文件"],
    "en": ["build website", "create website", "PHP website", "cleanup workspace", "delete files", "organize files", "technology review", "new technology", "tech radar", "Guild", "experience docs", "experience documents"]
  }
}


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)