@qlingzzy/qling 1.0.0

package/skills/examples/repo-triage/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: repo-triage
+description: 快速摸清陌生仓库：结构、入口、脚本、风险与下一步
+tags: [example, onboarding, repo]
+---
+
+# Repo Triage
+
+## 何时使用
+
+用户说「看看这个仓库」「快速上手这个项目」「分析项目结构」时加载。
+
+## 步骤
+
+1. **定位入口**
+   - 读 `README.md`、`package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod`（存在哪个读哪个）
+   - 记录 scripts / 依赖管理器
+
+2. **结构鸟瞰**
+   - 列出顶层目录（`bash`：`dir` / `ls`）
+   - 识别 `src/`、`tests/`、`docs/`、配置目录
+
+3. **可运行性**
+   - 找到最小启动命令（build / test / start）
+   - 不要自动 `npm install` 除非用户要求
+
+4. **风险与边界**
+   - 是否有 `.env.example`（不要读真实 `.env` 内容到对话里展示密钥）
+   - 是否有 CI（`.github/workflows`）
+
+5. **输出格式**（中文）
+
+```markdown
+## 仓库一览
+- 技术栈:
+- 入口:
+- 关键脚本:
+
+## 建议下一步
+1. …
+2. …
+
+## 风险
+- …
+```
+
+## 约束
+
+- 默认只读；需要改文件先说明原因
+- Plan Mode 下只输出计划，不写盘

package/skills/qling.md

@@ -0,0 +1,42 @@
+---
+name: qling
+description: 轻灵 Agent 自身使用指南
+---
+
+# 轻灵 Agent 使用指南
+
+## 快速开始
+```bash
+cd C:/Users/Lenovo/projects/qling
+node dist/index.js "你的任务"       # 一次性执行
+node dist/index.js chat             # 流式 TUI（默认）
+node dist/index.js repl             # 简易 REPL
+```
+
+## 工具列表
+- **bash**: 执行 Shell 命令（支持 timeout、cwd 参数）
+- **read**: 读取文件（path, offset, limit）
+- **write**: 写入文件（path, content）— 注意：覆盖写入，非追加
+- **search**: 搜索文件内容或文件名（pattern, file_glob, context, limit）
+- **planner**: 生成任务执行计划（goal）
+- **skill**: 动态加载知识文件（支持 @scope、多路径解析）
+- **todo**: 任务管理（action: list/add/done/cancel/remove/clear）
+- **url_fetch**: 受 Guard 约束的结构化网络请求（url, format）
+- **subtask**: 隔离子任务执行（独立上下文，共享记忆，深度=1）
+
+## CLI 模式
+- `run <task>` — 一次性执行任务后退出
+- `chat` — 流式 TUI 模式（默认，无参数时进入）
+- `repl` — 简易 REPL 模式
+
+## Guard 安全机制
+- M1: URL 白名单、私网拦截、脱敏、审计日志
+- M2: 速率限制、内容过滤（PII/注入检测）、工具权限矩阵
+
+## MCP 扩展
+- 支持 stdio 和 HTTP (Streamable) 两种 transport
+- 工具命名空间: `mcp__{server}__{tool}`
+
+## 已知限制
+- DeepSeek API 偶尔响应较慢，建议复杂任务设置较长超时
+- write 工具不会追加，会覆盖整个文件

package/skills/templates/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: my-skill
+description: 一句话说明该 skill 何时被加载、解决什么问题
+tags: [example, template]
+---
+
+# My Skill
+
+## 何时使用
+
+- 场景 A
+- 场景 B
+
+## 步骤
+
+1. 先用 `read` / `search` 收集事实
+2. 用 `planner` 列出计划（必要时 `/plan on`）
+3. 用 `patch` / `write` 做最小改动
+4. 用 `bash` 跑验证命令（测试/lint）
+
+## 约束
+
+- 不要写入 `.env` 或密钥文件
+- 不要在未确认时执行破坏性命令
+- 输出中不要回显密钥
+
+## 验收
+
+- [ ] 行为符合描述
+- [ ] 有可复现的验证命令
+
+## 示例
+
+```text
+用户: ……
+Agent: ……
+```