# ai-ws

**Repository Path**: xzbd/ai-ws

## Basic Information

- **Project Name**: ai-ws
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Workspace

一个用于收集、整理和复用个人 AI 能力的开放式知识库。

这里主要围绕 [OpenCode](https://opencode.ai/) 整理自己喜欢的 `Skill`、`MCP`、`Agent`、提示词、工具配置和实践笔记。它既可以作为个人 AI 工具箱，也可以作为探索 AI 编程工作流的长期记录。

> 这个仓库还在持续建设中。内容会随着使用体验不断调整，欢迎把它当作一份可以一起完善的 AI 工作台。

## 已收录资源

### `de-ai-writing`

面向中文正式文档和技术文档的去 AI 化修订 Skill。它通过识别设问自答、伪小标题、机械枚举、宣传腔、空泛强调和 AI 自我指涉等模式，帮助将 AI 生成的初稿改写得更自然、准确，更接近领域专家的写作习惯。

- 类型：Skill
- 状态：在用
- 适用场景：论证报告、技术标准、课题申报书、研究方案、实施方案、汇报材料、设计文档等
- 文件：[`skills/de-ai-writing/SKILL.md`](skills/de-ai-writing/SKILL.md)
- 参考资料：[`skills/de-ai-writing/references/pattern-catalog.md`](skills/de-ai-writing/references/pattern-catalog.md)
- 来源：本机 OpenCode Skill，整理自 `C:\Users\ghostcloud\.agents\skills\de-ai-writing\`

## 这个项目收集什么

- **Skills**：为 AI 注入特定领域知识、工作流程和操作规范的技能说明。
- **MCP**：让 AI 能够访问文件、数据库、浏览器、接口和其他外部能力的工具服务。
- **Agents**：面向特定目标或角色的智能代理配置，例如代码助手、文档助手和测试助手。
- **Prompts**：经过实践验证的系统提示词、任务模板和常用指令。
- **Configs**：OpenCode 及相关工具的配置示例、权限设置和组合方式。
- **Notes**：安装记录、使用心得、踩坑说明和效果对比。

## 为什么要维护它

AI 工具越来越多，但真正有价值的往往不是“知道一个工具”，而是知道它适合什么场景、如何配置，以及怎样和其他能力组合起来。

这个项目希望解决几个实际问题：

1. 把零散收藏的 AI 资源集中起来，方便查找。
2. 记录真实使用场景，而不是只保留工具名称和链接。
3. 沉淀可复制的 OpenCode 工作流，减少重复配置。
4. 区分稳定可用、正在尝试和仅供参考的内容。
5. 让每一次试用都留下结果，方便以后复盘和取舍。

## 目录建议

随着内容增加，建议按下面的方式组织：

```text
.
├── skills/                 # OpenCode Skill 收集与说明
├── mcp/                    # MCP 服务、安装方式和配置示例
├── agents/                 # Agent 配置与适用场景
├── prompts/                # 提示词和任务模板
├── workflows/              # 可复用的工作流
├── notes/                  # 使用笔记、踩坑记录和对比
└── README.md
```

目录可以根据实际内容调整，不要求所有分类一开始就存在。比起追求完整，更重要的是每一项内容都能被快速理解和复用。

## OpenCode 中的基本使用方式

OpenCode 的具体配置方式可能会随版本变化。下面的内容仅作为配置思路示例，请以当前使用的 OpenCode 版本和官方文档为准。

### 使用 Skill

将 Skill 放到 OpenCode 约定的技能目录中，并在任务中明确告诉 AI 使用该 Skill。一个好的 Skill 通常应该说明：

- 解决什么问题
- 适用于什么场景
- 不适用于什么场景
- 具体执行步骤
- 输入、输出和验证方式
- 常见限制与注意事项

### 使用 MCP

MCP 服务通常需要先安装或启动服务，再在 OpenCode 配置中声明服务名称、启动命令和必要参数。配置示例可以采用类似下面的结构：

```jsonc
{
  "mcp": {
    "example-server": {
      "command": "your-mcp-command",
      "args": [],
      "env": {
        "EXAMPLE_API_KEY": "${EXAMPLE_API_KEY}"
      }
    }
  }
}
```

不要把真实密钥、Token、密码或私有地址提交到仓库。建议使用环境变量，并提供一个不含敏感信息的配置模板。

### 使用 Agent

Agent 配置应尽量写清楚它的职责边界。例如：

```text
名称：frontend-reviewer
定位：审查前端代码的可维护性、可访问性和潜在回归
输入：待审查的文件、变更说明、相关测试
输出：按严重程度排序的问题、文件位置和验证建议
限制：不直接修改代码，除非用户明确授权
```

清晰的边界有助于降低误操作，也方便把 Agent 和 Skill、MCP 组合成稳定工作流。

## 推荐的收录格式

每新增一项资源，建议至少记录以下信息：

```markdown
# 资源名称

- 类型：Skill / MCP / Agent / Prompt / Workflow
- 来源：项目地址或文档地址
- 状态：在用 / 试用 / 待验证 / 已弃用
- 适用场景：它解决什么问题
- 使用方式：安装、配置和调用步骤
- 依赖条件：运行环境、账号、密钥或其他服务
- 优点：实际使用中表现好的地方
- 局限：已知问题、边界和成本
- 最后验证：YYYY-MM-DD

## 示例

给出一个尽量短、可以复现的使用示例。
```

如果资源来自第三方，还应保留原始链接、许可证信息和作者署名，不直接复制受限制的内容。

## 如何开始

1. 浏览对应分类，找到感兴趣的 Skill、MCP 或 Agent。
2. 阅读资源说明、依赖条件和许可证信息。
3. 在本地或独立环境中试用，先确认权限范围和数据安全风险。
4. 根据当前 OpenCode 版本完成配置。
5. 用一个真实但不敏感的任务验证效果。
6. 将验证结果、适用边界和改进建议补充到对应笔记中。

## 收录标准

优先收录符合以下条件的内容：

- 能解决明确的问题，而不只是概念展示。
- 文档、仓库或安装来源清晰可追溯。
- 许可协议允许使用、修改或再分发时，已按要求保留说明。
- 已经实际试用，或明确标注为“待验证”。
- 配置中不包含密钥、个人隐私和内部敏感信息。
- 对版本要求、系统要求和已知限制有基本记录。

## 安全与隐私

使用 AI 工具时，请特别关注以下事项：

- 不要提交 API Key、Access Token、Cookie、密码和私钥。
- 不要把客户资料、源代码、个人信息或内部文档直接发送给未知服务。
- 为 MCP 和 Agent 配置最小必要权限。
- 安装第三方资源前检查来源、许可证和实际启动命令。
- 涉及写文件、执行命令、网络访问或删除数据的能力时，先在隔离环境验证。
- 对 AI 生成的代码、命令和结论进行人工复核。

## 版本与状态说明

资源的可用性可能受到 OpenCode、模型、操作系统和第三方服务版本影响。因此每项资源都建议标注验证日期和状态：

| 状态 | 含义 |
| --- | --- |
| 在用 | 当前工作流中稳定使用 |
| 试用 | 已经使用，但仍在观察效果 |
| 待验证 | 已收集，尚未完成本地验证 |
| 已弃用 | 不再推荐使用，保留记录供参考 |

## 参与完善

欢迎通过 Issue 或 Pull Request 分享：

- 好用的 OpenCode Skill、MCP 或 Agent
- 可复用的提示词和工作流
- 安装配置问题及解决方案
- 版本变化带来的兼容性问题
- 对现有内容的纠错和改进建议

提交内容时，请尽量说明资源来源、适用环境、验证结果和许可证信息，并确认没有包含任何敏感数据。

## 许可证

仓库中的原创整理内容和第三方资源分别遵循各自适用的许可证。引用第三方项目时，请以其原始仓库或官方文档中的许可证声明为准。

如果后续需要统一授权仓库中的原创内容，可以在项目成熟后补充明确的 LICENSE 文件。

## 相关链接

- [OpenCode 官方网站](https://opencode.ai/)
- [OpenCode GitHub](https://github.com/anomalyco/opencode)
- [Model Context Protocol](https://modelcontextprotocol.io/)