mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-21 23:08:06 +00:00
chore: assets - reorganize resource directories
This commit is contained in:
tukuaiai
@@ -14,7 +14,7 @@ assets/skills/
|
||||
│ ├── scripts/ # (可选) 可执行脚本/自动化
|
||||
│ ├── assets/ # (可选) 模板/样例/静态资源
|
||||
│ └── agents/ # (可选) Agent 元数据（如 openai.yaml）
|
||||
└── skills-skills/ # 元技能：生成/校验/脚手架化其它技能
|
||||
└── auto-skill/ # 元技能：生成/校验/脚手架化其它技能
|
||||
```
|
||||
|
||||
## 外部仓库引用（约定）
|
||||
@@ -49,5 +49,5 @@ assets/skills/
|
||||
- `assets/skills/canvas-dev/`：Canvas 白板驱动开发
|
||||
- `assets/skills/sop-generator/`：SOP 生成与规范化
|
||||
- `assets/skills/markdown-to-epub/`：Markdown → EPUB 稳定构建
|
||||
- `assets/skills/skills-skills/`：元技能（技能生成/校验/脚手架）
|
||||
- `assets/skills/auto-skill/`：元技能（技能生成/校验/脚手架）
|
||||
- `assets/skills/claude-official-skills/`：Claude 官方 skills 仓库（Anthropic）的软链接入口
|
||||
|
||||
@@ -4,11 +4,11 @@
|
||||
|
||||
## Skills 一览表
|
||||
|
||||
### 🔮 元技能（生成 Skills 的 Skills）
|
||||
### 🔮 元技能（生成与维护 Skills）
|
||||
|
||||
| 技能 | 说明 |
|
||||
|:---|:---|
|
||||
| [skills-skills](./skills-skills/SKILL.md) | ⭐ 生成 Skills 的 Skills |
|
||||
| [auto-skill](./auto-skill/SKILL.md) | ⭐ 生成、重构与校验 Skills |
|
||||
| [sop-generator](./sop-generator/SKILL.md) | SOP 生成与规范化 |
|
||||
|
||||
### 🤖 AI 工具
|
||||
@@ -57,7 +57,7 @@
|
||||
## 外部技能仓库（软链接）
|
||||
|
||||
- `assets/skills/claude-official-skills/`：来自 Claude 官方 skills 仓库（Anthropic）。
|
||||
本仓库以 Git submodule 的形式落在 `assets/repo/claude-official-skills/`，
|
||||
本仓库以 Git submodule 的形式落在 `assets/repos/claude-official-skills/`，
|
||||
并通过软链接暴露到 `assets/skills/` 下便于浏览与复用。
|
||||
- 初始化/更新方式：`git submodule update --init --recursive`
|
||||
- Skills 大全网站：`https://skills.sh/`
|
||||
@@ -66,7 +66,7 @@
|
||||
|
||||
```bash
|
||||
# 查看元技能
|
||||
cat assets/skills/skills-skills/SKILL.md
|
||||
cat assets/skills/auto-skill/SKILL.md
|
||||
|
||||
# 查看无头 CLI 技能
|
||||
cat assets/skills/headless-cli/SKILL.md
|
||||
@@ -79,12 +79,12 @@ cat assets/skills/postgresql/SKILL.md
|
||||
|
||||
使用元技能生成：
|
||||
1. 准备领域资料（文档、代码、规范）
|
||||
2. 将资料和 `skills-skills/SKILL.md` 一起提供给 AI
|
||||
2. 将资料和 `auto-skill/SKILL.md` 一起提供给 AI
|
||||
3. AI 会生成针对该领域的专用 Skill
|
||||
|
||||
## 相关资源
|
||||
|
||||
- [元技能文件](./skills-skills/SKILL.md) - 生成 Skills 的 Skills
|
||||
- [提示词库](../prompts/) - 更细粒度的提示词集合
|
||||
- [元技能文件](./auto-skill/SKILL.md) - 生成、重构与校验 Skills
|
||||
- [提示词库](../prompt/) - 更细粒度的提示词集合
|
||||
- [文档库](../documents/) - 方法论与开发经验
|
||||
- [skills.sh](https://skills.sh/) - Skill 大全网站
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
# assets/skills/auto-skill
|
||||
|
||||
This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding.
|
||||
|
||||
## Layout
|
||||
|
||||
```text
|
||||
auto-skill/
|
||||
|-- AGENTS.md
|
||||
|-- SKILL.md
|
||||
|-- assets/
|
||||
| |-- template-minimal.md
|
||||
| `-- template-complete.md
|
||||
|-- scripts/
|
||||
| |-- Skill_Seekers-development/
|
||||
| |-- create-skill.sh
|
||||
| |-- skill-seekers-bootstrap.sh
|
||||
| |-- skill-seekers-configs -> Skill_Seekers-development/configs
|
||||
| |-- skill-seekers-import.sh
|
||||
| |-- skill-seekers.sh
|
||||
| |-- skill-seekers-src -> Skill_Seekers-development/src
|
||||
| |-- skill-seekers-update.sh
|
||||
| `-- validate-skill.sh
|
||||
`-- references/
|
||||
|-- index.md
|
||||
|-- README.md
|
||||
|-- anti-patterns.md
|
||||
|-- skill-seekers.md
|
||||
|-- quality-checklist.md
|
||||
`-- skill-spec.md
|
||||
```
|
||||
|
||||
## File Responsibilities
|
||||
|
||||
- `assets/skills/auto-skill/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling).
|
||||
- `assets/skills/auto-skill/assets/template-minimal.md`: minimal template (small domains / quick bootstrap).
|
||||
- `assets/skills/auto-skill/assets/template-complete.md`: full template (production-grade / complex domains).
|
||||
- `assets/skills/auto-skill/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite).
|
||||
- `assets/skills/auto-skill/scripts/Skill_Seekers-development/`: vendored Skill Seekers source snapshot (code + configs; excludes upstream Markdown docs).
|
||||
- `assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the vendored Skill Seekers tool.
|
||||
- `assets/skills/auto-skill/scripts/skill-seekers.sh`: run Skill Seekers from vendored source (docs/github/pdf -> output/<name>/).
|
||||
- `assets/skills/auto-skill/scripts/skill-seekers-import.sh`: import output/<name>/ into the canonical assets/skills/<name>/ tree.
|
||||
- `assets/skills/auto-skill/scripts/skill-seekers-update.sh`: update the vendored source snapshot from upstream (network required).
|
||||
- `assets/skills/auto-skill/scripts/validate-skill.sh`: spec validator (supports `--strict`).
|
||||
- `assets/skills/auto-skill/references/index.md`: navigation for this meta-skill's reference docs.
|
||||
- `assets/skills/auto-skill/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo).
|
||||
- `assets/skills/auto-skill/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER).
|
||||
- `assets/skills/auto-skill/references/quality-checklist.md`: quality gate checklist + scoring.
|
||||
- `assets/skills/auto-skill/references/anti-patterns.md`: common failure modes and how to fix them.
|
||||
- `assets/skills/auto-skill/references/skill-seekers.md`: how to use the vendored tool as a mandatory first-draft generator.
|
||||
|
||||
## Dependencies & Boundaries
|
||||
|
||||
- `scripts/*.sh`: depend on `bash` + common POSIX tooling; some scripts require extra tooling:
|
||||
- `skill-seekers-bootstrap.sh`: requires `python3` + `pip` (network required for PyPI).
|
||||
- `skill-seekers-update.sh`: requires `curl` + `tar` + `rsync` (network required).
|
||||
- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `assets/skills/<domain>/`.
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: skills-skills
|
||||
name: auto-skill
|
||||
description: "Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates."
|
||||
---
|
||||
|
||||
# Claude Skills Meta-Skill
|
||||
# Auto Skill
|
||||
|
||||
Turn scattered domain material into a Skill that is reusable, maintainable, and reliably activatable:
|
||||
- `SKILL.md` as the entrypoint (triggers, constraints, patterns, examples)
|
||||
@@ -47,29 +47,29 @@ This repo vendors the Skill Seekers source code inside this meta-skill so you ca
|
||||
Bootstrap dependencies (once):
|
||||
|
||||
```bash
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh
|
||||
```
|
||||
|
||||
Run Skill Seekers (from vendored source):
|
||||
|
||||
```bash
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- --version
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- scrape --config ./assets/skills/skills-skills/scripts/Skill_Seekers-development/configs/react.json
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- github --repo facebook/react --name react
|
||||
./assets/skills/auto-skill/scripts/skill-seekers.sh -- --version
|
||||
./assets/skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./assets/skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json
|
||||
./assets/skills/auto-skill/scripts/skill-seekers.sh -- github --repo facebook/react --name react
|
||||
```
|
||||
|
||||
Import the generated skill into this repo's canonical `assets/skills/` tree:
|
||||
|
||||
```bash
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-import.sh react
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-import.sh react --force
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-import.sh react
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-import.sh react --force
|
||||
```
|
||||
|
||||
Update the vendored source snapshot (optional, network required):
|
||||
|
||||
```bash
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-update.sh
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-update.sh --ref main
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-update.sh
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-update.sh --ref main
|
||||
```
|
||||
|
||||
### Recommended Layout (Minimal -> Full)
|
||||
@@ -194,15 +194,15 @@ Validate locally:
|
||||
|
||||
```bash
|
||||
# From repo root (basic validation)
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/<skill-name>
|
||||
./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/<skill-name>
|
||||
|
||||
# From repo root (strict validation)
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/<skill-name> --strict
|
||||
./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/<skill-name> --strict
|
||||
|
||||
# From assets/skills/skills-skills/ (basic validation)
|
||||
# From assets/skills/auto-skill/ (basic validation)
|
||||
./scripts/validate-skill.sh ../<skill-name>
|
||||
|
||||
# From assets/skills/skills-skills/ (strict validation)
|
||||
# From assets/skills/auto-skill/ (strict validation)
|
||||
./scripts/validate-skill.sh ../<skill-name> --strict
|
||||
```
|
||||
|
||||
@@ -212,13 +212,13 @@ Generate a new Skill skeleton:
|
||||
|
||||
```bash
|
||||
# From repo root (generate into ./assets/skills/)
|
||||
./assets/skills/skills-skills/scripts/create-skill.sh my-skill --full --output assets/skills
|
||||
./assets/skills/auto-skill/scripts/create-skill.sh my-skill --full --output assets/skills
|
||||
|
||||
# From skills-skills/ (generate into ../ i.e. ./assets/skills/)
|
||||
# From auto-skill/ (generate into ../ i.e. ./assets/skills/)
|
||||
./scripts/create-skill.sh my-skill --full --output ..
|
||||
|
||||
# Minimal skeleton
|
||||
./assets/skills/skills-skills/scripts/create-skill.sh my-skill --minimal --output assets/skills
|
||||
./assets/skills/auto-skill/scripts/create-skill.sh my-skill --minimal --output assets/skills
|
||||
```
|
||||
|
||||
Templates:
|
||||
@@ -275,6 +275,6 @@ External (official):
|
||||
|
||||
## Maintenance
|
||||
|
||||
- Sources: local spec files in `assets/skills/skills-skills/references/` + upstream official docs in `references/README.md`
|
||||
- Sources: local spec files in `assets/skills/auto-skill/references/` + upstream official docs in `references/README.md`
|
||||
- Last updated: 2025-12-14
|
||||
- Known limits: `validate-skill.sh` is heuristic; strict mode assumes the recommended section headings
|
||||
+1
-1
@@ -75,7 +75,7 @@ Trigger when any of these applies:
|
||||
|
||||
## Quality Gate
|
||||
|
||||
Minimum checks before shipping (see meta-skill `skills-skills` for the full version):
|
||||
Minimum checks before shipping (see meta-skill `auto-skill` for the full version):
|
||||
|
||||
1. `description` is decidable ("what + when") and includes trigger keywords
|
||||
2. Has "When to Use This Skill" with decidable triggers
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
# Claude Skills Meta-Skill Reference Index
|
||||
# Auto Skill Reference Index
|
||||
|
||||
This directory contains long-form documentation that supports the `skills-skills` meta-skill.
|
||||
This directory contains long-form documentation that supports the `auto-skill` meta-skill.
|
||||
|
||||
## Start Here
|
||||
|
||||
@@ -0,0 +1,39 @@
|
||||
# Skill Seekers（内置工具）使用说明
|
||||
|
||||
本目录把 `Skill_Seekers-development` 的源码作为 `auto-skill` 的必备工具内置，用于把「文档 / GitHub 仓库 / PDF」快速转成一个可落地的 Skill 初稿。
|
||||
|
||||
## 目录约定
|
||||
|
||||
- 工具源码：`assets/skills/auto-skill/scripts/Skill_Seekers-development/`
|
||||
- 运行入口：`assets/skills/auto-skill/scripts/skill-seekers.sh`
|
||||
- 依赖初始化：`assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh`
|
||||
- 导入到本仓库：`assets/skills/auto-skill/scripts/skill-seekers-import.sh`
|
||||
- 更新源码快照：`assets/skills/auto-skill/scripts/skill-seekers-update.sh`（需要网络）
|
||||
|
||||
## 推荐工作流（强约束）
|
||||
|
||||
1. 用 Skill Seekers 生成初稿到 `output/<name>/`
|
||||
2. 导入到 `assets/skills/<name>/`
|
||||
3. 用 `validate-skill.sh --strict` 做质量闸门
|
||||
4. 回到 `auto-skill` 的规范对 `SKILL.md` 做“可激活性”与“边界”修订
|
||||
|
||||
## 最小可执行示例
|
||||
|
||||
```bash
|
||||
# 1) 初始化（只需一次）
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh
|
||||
|
||||
# 2) 生成（示例：抓 docs 配置）
|
||||
./assets/skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./assets/skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json
|
||||
|
||||
# 3) 导入到 skills/
|
||||
./assets/skills/auto-skill/scripts/skill-seekers-import.sh react
|
||||
|
||||
# 4) 严格校验
|
||||
./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/react --strict
|
||||
```
|
||||
|
||||
## 设计原则
|
||||
|
||||
- `assets/skills/auto-skill/` 负责：规范、模板、闸门、可激活性；不直接承载领域知识。
|
||||
- Skill Seekers 负责：抓取与初稿生成；最终交付仍以本仓库的 `validate-skill.sh --strict` 为准。
|
||||
+1
-1
@@ -107,5 +107,5 @@ Each Skill SHOULD include a `## Maintenance` section with:
|
||||
Before shipping, run the checklist in `quality-checklist.md` and (if available) the validator:
|
||||
|
||||
```bash
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/<skill-name> --strict
|
||||
./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/<skill-name> --strict
|
||||
```
|
||||
+2
-2
@@ -15,8 +15,8 @@ Notes:
|
||||
- Default output: current directory (creates ./<skill-name>/)
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/create-skill.sh postgresql --full --output assets/skills
|
||||
./assets/skills/skills-skills/scripts/create-skill.sh my-api --minimal --output assets/skills
|
||||
./skills/auto-skill/scripts/create-skill.sh postgresql --full --output assets/skills
|
||||
./skills/auto-skill/scripts/create-skill.sh my-api --minimal --output assets/skills
|
||||
EOF
|
||||
}
|
||||
|
||||
+3
-3
@@ -6,7 +6,7 @@ set -euo pipefail
|
||||
# Bootstraps a local venv for the vendored Skill Seekers source code.
|
||||
#
|
||||
# Output:
|
||||
# - Creates: assets/skills/skills-skills/scripts/.venv-skill-seekers/
|
||||
# - Creates: skills/auto-skill/scripts/.venv-skill-seekers/
|
||||
|
||||
usage() {
|
||||
cat <<'EOF'
|
||||
@@ -14,8 +14,8 @@ Usage:
|
||||
skill-seekers-bootstrap.sh [--venv <dir>]
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh --venv ./assets/skills/skills-skills/scripts/.venv-skill-seekers
|
||||
./skills/auto-skill/scripts/skill-seekers-bootstrap.sh
|
||||
./skills/auto-skill/scripts/skill-seekers-bootstrap.sh --venv ./skills/auto-skill/scripts/.venv-skill-seekers
|
||||
EOF
|
||||
}
|
||||
|
||||
+6
-6
@@ -3,7 +3,7 @@
|
||||
set -euo pipefail
|
||||
|
||||
# ==================== Purpose ====================
|
||||
# Import Skill Seekers output/NAME/ into this repo's assets/skills/NAME/.
|
||||
# Import Skill Seekers output/NAME/ into this repo's skills/NAME/.
|
||||
|
||||
usage() {
|
||||
cat <<'EOF'
|
||||
@@ -12,12 +12,12 @@ Usage:
|
||||
|
||||
Behavior:
|
||||
- Source: ./output/<skill-name>/
|
||||
- Dest: ./assets/skills/<skill-name>/
|
||||
- By default, refuses to overwrite an existing assets/skills/<skill-name>/SKILL.md
|
||||
- Dest: ./skills/<skill-name>/
|
||||
- By default, refuses to overwrite an existing skills/<skill-name>/SKILL.md
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-import.sh react
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-import.sh react --force
|
||||
./skills/auto-skill/scripts/skill-seekers-import.sh react
|
||||
./skills/auto-skill/scripts/skill-seekers-import.sh react --force
|
||||
EOF
|
||||
}
|
||||
|
||||
@@ -64,7 +64,7 @@ fi
|
||||
|
||||
repo_root="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/../../../.." && pwd)"
|
||||
src_dir="${repo_root}/output/${skill_name}"
|
||||
dest_dir="${repo_root}/assets/skills/${skill_name}"
|
||||
dest_dir="${repo_root}/skills/${skill_name}"
|
||||
|
||||
[[ -d "$src_dir" ]] || die "Missing Skill Seekers output dir: $src_dir"
|
||||
[[ -f "$src_dir/SKILL.md" ]] || die "Missing output SKILL.md: $src_dir/SKILL.md"
|
||||
+3
-3
@@ -19,9 +19,9 @@ Defaults:
|
||||
--ref main
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-update.sh
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-update.sh --ref v2.1.1
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-update.sh --dry-run
|
||||
./skills/auto-skill/scripts/skill-seekers-update.sh
|
||||
./skills/auto-skill/scripts/skill-seekers-update.sh --ref v2.1.1
|
||||
./skills/auto-skill/scripts/skill-seekers-update.sh --dry-run
|
||||
EOF
|
||||
}
|
||||
|
||||
+3
-3
@@ -14,9 +14,9 @@ Usage:
|
||||
skill-seekers.sh [--venv <dir>] -- <skill-seekers args...>
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- --version
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- scrape --config ./assets/skills/skills-skills/scripts/Skill_Seekers-development/configs/react.json
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- github --repo facebook/react --name react
|
||||
./skills/auto-skill/scripts/skill-seekers.sh -- --version
|
||||
./skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json
|
||||
./skills/auto-skill/scripts/skill-seekers.sh -- github --repo facebook/react --name react
|
||||
EOF
|
||||
}
|
||||
|
||||
+2
-2
@@ -13,8 +13,8 @@ What it does:
|
||||
- In --strict mode, enforces the recommended section layout
|
||||
|
||||
Examples:
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/postgresql
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/my-skill --strict
|
||||
./skills/auto-skill/scripts/validate-skill.sh skills/postgresql
|
||||
./skills/auto-skill/scripts/validate-skill.sh skills/my-skill --strict
|
||||
EOF
|
||||
}
|
||||
|
||||
@@ -35,5 +35,5 @@ canvas-dev/
|
||||
## 相关资源
|
||||
|
||||
- [Canvas白板驱动开发详解](../../documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md)
|
||||
- [Canvas开发工作流](../../workflow/canvas-dev/)
|
||||
- [元技能: skills-skills](../skills-skills/SKILL.md)
|
||||
- [Canvas开发工作流](../../documents/workflow/canvas-dev/)
|
||||
- [元技能: auto-skill](../auto-skill/SKILL.md)
|
||||
|
||||
@@ -206,10 +206,10 @@ Canvas：代码 ⇄ 白板 ⇄ AI ⇄ 人类（白板为单一真相源）
|
||||
|
||||
## References
|
||||
|
||||
- [AI架构总师完整提示词](../../workflow/canvas-dev/Obsidian%20Canvas%20AI驱动的项目架构洞察与生成引擎.md) - 最新最完整的提示词
|
||||
- [Canvas驱动开发完整工作流](../../workflow/canvas-dev/workflow.md) - 15步完整流程
|
||||
- [AI架构总师完整提示词](../../documents/workflow/canvas-dev/Obsidian%20Canvas%20AI驱动的项目架构洞察与生成引擎.md) - 最新最完整的提示词
|
||||
- [Canvas驱动开发完整工作流](../../documents/workflow/canvas-dev/workflow.md) - 15步完整流程
|
||||
- [Canvas白板驱动开发详解](../../documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md) - 方法论详解
|
||||
- [白板驱动开发系统提示词（在线提示词库入口）](../../prompts/README.md) - 系统提示词已迁移到云端表格
|
||||
- [白板驱动开发系统提示词（在线提示词库入口）](../../prompt/README.md) - 系统提示词已迁移到云端表格
|
||||
- [Obsidian Canvas 官方文档](https://obsidian.md/canvas)
|
||||
- `references/index.md` - 本地参考文档导航
|
||||
|
||||
|
||||
@@ -6,15 +6,15 @@
|
||||
|
||||
| 资源 | 路径/链接 | 说明 |
|
||||
|:---|:---|:---|
|
||||
| AI架构总师完整提示词 | [Obsidian Canvas AI驱动的项目架构洞察与生成引擎.md](../../../workflow/canvas-dev/Obsidian%20Canvas%20AI驱动的项目架构洞察与生成引擎.md) | 最新最完整的提示词（最高优先级） |
|
||||
| Canvas驱动开发完整工作流 | [workflow.md](../../../workflow/canvas-dev/workflow.md) | 15步完整流程 |
|
||||
| AI架构总师完整提示词 | [Obsidian Canvas AI驱动的项目架构洞察与生成引擎.md](../../../documents/workflow/canvas-dev/Obsidian%20Canvas%20AI驱动的项目架构洞察与生成引擎.md) | 最新最完整的提示词（最高优先级） |
|
||||
| Canvas驱动开发完整工作流 | [workflow.md](../../../documents/workflow/canvas-dev/workflow.md) | 15步完整流程 |
|
||||
|
||||
### 核心文档
|
||||
|
||||
| 文档 | 路径 | 说明 |
|
||||
|:---|:---|:---|
|
||||
| Canvas白板驱动开发详解 | `../../../documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md` | 方法论详解 |
|
||||
| 白板驱动开发系统提示词（在线提示词库入口） | `../../../prompts/README.md` | 系统提示词已迁移到云端表格 |
|
||||
| 白板驱动开发系统提示词（在线提示词库入口） | `../../../prompt/README.md` | 系统提示词已迁移到云端表格 |
|
||||
| Canvas JSON 规范 | [canvas-json-spec.md](./canvas-json-spec.md) | Obsidian Canvas JSON 格式 |
|
||||
|
||||
### AI架构总师核心概念
|
||||
@@ -47,17 +47,17 @@
|
||||
|
||||
| 提示词 | 路径 |
|
||||
|:---|:---|
|
||||
| 架构分析提示词 | `../../../workflow/canvas-dev/prompts/01-架构分析.md` |
|
||||
| 白板驱动编码提示词 | `../../../workflow/canvas-dev/prompts/02-白板驱动编码.md` |
|
||||
| 白板同步检查提示词 | `../../../workflow/canvas-dev/prompts/03-白板同步检查.md` |
|
||||
| 架构分析提示词 | `../../../documents/workflow/canvas-dev/prompts/01-架构分析.md` |
|
||||
| 白板驱动编码提示词 | `../../../documents/workflow/canvas-dev/prompts/02-白板驱动编码.md` |
|
||||
| 白板同步检查提示词 | `../../../documents/workflow/canvas-dev/prompts/03-白板同步检查.md` |
|
||||
|
||||
### 模板
|
||||
|
||||
| 模板 | 路径 |
|
||||
|:---|:---|
|
||||
| 项目白板模板 | `../../../workflow/canvas-dev/templates/project.canvas` |
|
||||
| 模块白板模板 | `../../../workflow/canvas-dev/templates/module.canvas` |
|
||||
| 示例项目白板 | `../../../workflow/canvas-dev/examples/demo-project.canvas` |
|
||||
| 项目白板模板 | `../../../documents/workflow/canvas-dev/templates/project.canvas` |
|
||||
| 模块白板模板 | `../../../documents/workflow/canvas-dev/templates/module.canvas` |
|
||||
| 示例项目白板 | `../../../documents/workflow/canvas-dev/examples/demo-project.canvas` |
|
||||
|
||||
### 外部链接
|
||||
|
||||
|
||||
@@ -158,6 +158,6 @@ jobs:
|
||||
## 相关资源
|
||||
|
||||
- [Canvas白板驱动开发详解](../../../documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md)
|
||||
- [架构分析提示词](../../../workflow/canvas-dev/prompts/01-架构分析.md)
|
||||
- [白板驱动编码提示词](../../../workflow/canvas-dev/prompts/02-白板驱动编码.md)
|
||||
- [白板同步检查提示词](../../../workflow/canvas-dev/prompts/03-白板同步检查.md)
|
||||
- [架构分析提示词](../../../documents/workflow/canvas-dev/prompts/01-架构分析.md)
|
||||
- [白板驱动编码提示词](../../../documents/workflow/canvas-dev/prompts/02-白板驱动编码.md)
|
||||
- [白板同步检查提示词](../../../documents/workflow/canvas-dev/prompts/03-白板同步检查.md)
|
||||
|
||||
@@ -94,7 +94,7 @@ description: "文档驱动开发（DDD）文档管家：以仓库真实证据为
|
||||
|
||||
## 维护
|
||||
|
||||
- 来源：提示词库（在线表格入口见 `assets/prompts/README.md`）；元技能 `assets/skills/skills-skills/`；自动化辅助工具 `assets/repo/Skill_Seekers-development`.
|
||||
- 来源：提示词库（在线表格入口见 `assets/prompt/README.md`）；元技能 `assets/skills/auto-skill/`；自动化辅助工具 `assets/repos/Skill_Seekers-development`.
|
||||
- 最后更新：2025-12-20
|
||||
- 已知限制：依赖用户提供真实证据；大体量仓库需分批；不输出敏感值。
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
|
||||
## 自动化采集（可选）
|
||||
|
||||
- 需要批量抓取外部文档/代码仓库时，可用 `assets/repo/Skill_Seekers-development` 的 CLI（如 `skill-seekers scrape --config <config.json>`）生成参考素材，再按本技能流程落盘。
|
||||
- 需要批量抓取外部文档/代码仓库时，可用 `assets/repos/Skill_Seekers-development` 的 CLI（如 `skill-seekers scrape --config <config.json>`）生成参考素材，再按本技能流程落盘。
|
||||
|
||||
## 交付物检查
|
||||
|
||||
|
||||
@@ -1,57 +0,0 @@
|
||||
# assets/skills/skills-skills
|
||||
|
||||
This directory is a **meta-skill**: it turns arbitrary domain material (docs/APIs/code/specs) into a reusable Skill (`SKILL.md` + `references/` + `scripts/` + `assets/`), and ships an executable quality gate + scaffolding.
|
||||
|
||||
## Layout
|
||||
|
||||
```
|
||||
skills-skills/
|
||||
|-- AGENTS.md
|
||||
|-- SKILL.md
|
||||
|-- assets/
|
||||
| |-- template-minimal.md
|
||||
| `-- template-complete.md
|
||||
|-- scripts/
|
||||
| |-- Skill_Seekers-development/
|
||||
| |-- create-skill.sh
|
||||
| |-- skill-seekers-bootstrap.sh
|
||||
| |-- skill-seekers-configs -> Skill_Seekers-development/configs
|
||||
| |-- skill-seekers-import.sh
|
||||
| |-- skill-seekers.sh
|
||||
| |-- skill-seekers-src -> Skill_Seekers-development/src
|
||||
| |-- skill-seekers-update.sh
|
||||
| `-- validate-skill.sh
|
||||
`-- references/
|
||||
|-- index.md
|
||||
|-- README.md
|
||||
|-- anti-patterns.md
|
||||
|-- skill-seekers.md
|
||||
|-- quality-checklist.md
|
||||
`-- skill-spec.md
|
||||
```
|
||||
|
||||
## File Responsibilities
|
||||
|
||||
- `assets/skills/skills-skills/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling).
|
||||
- `assets/skills/skills-skills/assets/template-minimal.md`: minimal template (small domains / quick bootstrap).
|
||||
- `assets/skills/skills-skills/assets/template-complete.md`: full template (production-grade / complex domains).
|
||||
- `assets/skills/skills-skills/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite).
|
||||
- `assets/skills/skills-skills/scripts/Skill_Seekers-development/`: vendored Skill Seekers source snapshot (code + configs; excludes upstream Markdown docs).
|
||||
- `assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the vendored Skill Seekers tool.
|
||||
- `assets/skills/skills-skills/scripts/skill-seekers.sh`: run Skill Seekers from vendored source (docs/github/pdf -> output/<name>/).
|
||||
- `assets/skills/skills-skills/scripts/skill-seekers-import.sh`: import output/<name>/ into the canonical assets/skills/<name>/ tree.
|
||||
- `assets/skills/skills-skills/scripts/skill-seekers-update.sh`: update the vendored source snapshot from upstream (network required).
|
||||
- `assets/skills/skills-skills/scripts/validate-skill.sh`: spec validator (supports `--strict`).
|
||||
- `assets/skills/skills-skills/references/index.md`: navigation for this meta-skill's reference docs.
|
||||
- `assets/skills/skills-skills/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo).
|
||||
- `assets/skills/skills-skills/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER).
|
||||
- `assets/skills/skills-skills/references/quality-checklist.md`: quality gate checklist + scoring.
|
||||
- `assets/skills/skills-skills/references/anti-patterns.md`: common failure modes and how to fix them.
|
||||
- `assets/skills/skills-skills/references/skill-seekers.md`: how to use the vendored tool as a mandatory first-draft generator.
|
||||
|
||||
## Dependencies & Boundaries
|
||||
|
||||
- `scripts/*.sh`: depend on `bash` + common POSIX tooling; some scripts require extra tooling:
|
||||
- `skill-seekers-bootstrap.sh`: requires `python3` + `pip` (network required for PyPI).
|
||||
- `skill-seekers-update.sh`: requires `curl` + `tar` + `rsync` (network required).
|
||||
- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `assets/skills/<domain>/`.
|
||||
@@ -1,39 +0,0 @@
|
||||
# Skill Seekers（内置工具）使用说明
|
||||
|
||||
本目录把 `Skill_Seekers-development` 的源码作为 `skills-skills` 的必备工具内置，用于把「文档 / GitHub 仓库 / PDF」快速转成一个可落地的 Skill 初稿。
|
||||
|
||||
## 目录约定
|
||||
|
||||
- 工具源码：`assets/skills/skills-skills/scripts/Skill_Seekers-development/`
|
||||
- 运行入口：`assets/skills/skills-skills/scripts/skill-seekers.sh`
|
||||
- 依赖初始化：`assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh`
|
||||
- 导入到本仓库：`assets/skills/skills-skills/scripts/skill-seekers-import.sh`
|
||||
- 更新源码快照：`assets/skills/skills-skills/scripts/skill-seekers-update.sh`（需要网络）
|
||||
|
||||
## 推荐工作流（强约束）
|
||||
|
||||
1. 用 Skill Seekers 生成初稿到 `output/<name>/`
|
||||
2. 导入到 `assets/skills/<name>/`
|
||||
3. 用 `validate-skill.sh --strict` 做质量闸门
|
||||
4. 回到 `skills-skills` 的规范对 `SKILL.md` 做“可激活性”与“边界”修订
|
||||
|
||||
## 最小可执行示例
|
||||
|
||||
```bash
|
||||
# 1) 初始化（只需一次）
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh
|
||||
|
||||
# 2) 生成（示例：抓 docs 配置）
|
||||
./assets/skills/skills-skills/scripts/skill-seekers.sh -- scrape --config ./assets/skills/skills-skills/scripts/Skill_Seekers-development/configs/react.json
|
||||
|
||||
# 3) 导入到 skills/
|
||||
./assets/skills/skills-skills/scripts/skill-seekers-import.sh react
|
||||
|
||||
# 4) 严格校验
|
||||
./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/react --strict
|
||||
```
|
||||
|
||||
## 设计原则
|
||||
|
||||
- `skills/skills-skills/` 负责：规范、模板、闸门、可激活性；不直接承载领域知识。
|
||||
- Skill Seekers 负责：抓取与初稿生成；最终交付仍以本仓库的 `validate-skill.sh --strict` 为准。
|
||||
@@ -1 +0,0 @@
|
||||
Skill_Seekers-development/configs
|
||||
@@ -1 +0,0 @@
|
||||
Skill_Seekers-development/src
|
||||
@@ -5,7 +5,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane，
|
||||
|
||||
# tmux-autopilot Skill
|
||||
|
||||
让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `assets/repo/.tmux`（gpakosz/oh-my-tmux）。
|
||||
让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `assets/repos/.tmux`（gpakosz/oh-my-tmux）。
|
||||
|
||||
## When to Use This Skill
|
||||
|
||||
@@ -14,7 +14,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane，
|
||||
- 需要向指定 pane 发送按键/命令（确认 `y`、`Enter`、`Ctrl+C`、广播同一窗口）。
|
||||
- 需要批量巡检/接管多 AI 终端（蜂群协作、自动救援卡死任务）。
|
||||
- 需要快速回忆 oh-my-tmux 快捷键、前缀或同步面板操作。
|
||||
- 需要在当前仓库复用 `assets/repo/.tmux` 配置并避免修改主配置。
|
||||
- 需要在当前仓库复用 `assets/repos/.tmux` 配置并避免修改主配置。
|
||||
|
||||
## Not For / Boundaries
|
||||
|
||||
@@ -85,8 +85,8 @@ tmux attach -t ai-hub
|
||||
|
||||
**启用 oh-my-tmux 配置（仓库内版本）**
|
||||
```bash
|
||||
ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repo/.tmux/.tmux.conf ~/.tmux.conf
|
||||
cp -n /home/lenovo/zip/vibe-coding-cn/assets/repo/.tmux/.tmux.conf.local ~/.tmux.conf.local
|
||||
ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf ~/.tmux.conf
|
||||
cp -n /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf.local ~/.tmux.conf.local
|
||||
```
|
||||
|
||||
**记录 pane 输出到文件**
|
||||
@@ -156,17 +156,17 @@ tmux pipe-pane -t <session>:<window>.<pane> -o 'cat >> /tmp/tmux-<session>-<wind
|
||||
|
||||
## Maintenance
|
||||
|
||||
- Sources: `assets/repo/.tmux/README.md`、蜂群实战提示词、Skill Seeker 生成的抓取材料（如需扩展自动化）。
|
||||
- Sources: `assets/repos/.tmux/README.md`、蜂群实战提示词、Skill Seeker 生成的抓取材料（如需扩展自动化）。
|
||||
- Last updated: 2026-01-17
|
||||
- Known limits: 未涵盖 tmux 插件管理（tpm）及多用户共享权限配置；需时再补充。
|
||||
|
||||
## Quality Gate
|
||||
|
||||
发布前自检（配合 `skills-skills` 校验脚本）：
|
||||
发布前自检（配合 `auto-skill` 校验脚本）：
|
||||
1. `description` 已含“capture-pane/send-keys/蜂群”等触发关键词。
|
||||
2. 「When to Use」「Not For」已覆盖边界；前缀/版本要求清晰。
|
||||
3. Quick Reference ≤ 20 条且均可直接执行；无长篇解释。
|
||||
4. ≥3 个端到端示例，含输入/步骤/验收。
|
||||
5. 长文档放在 `references/` 并可导航；无文档堆砌。
|
||||
6. 不确定项给出验证路径；禁止虚构 tmux 行为。
|
||||
7. 运行 `assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/tmux-autopilot` 通过。
|
||||
7. 运行 `assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/tmux-autopilot` 通过。
|
||||
|
||||
@@ -41,7 +41,7 @@ echo "audit pipes enabled under /tmp/*-ai-hub-*.log"
|
||||
> 目的：在需要更全面文档时，用仓库自带的 `Skill_Seekers-development` 自动抓取 gpakosz/.tmux 与 README，生成扩展参考文件，再手动筛选进 `references/`。
|
||||
|
||||
```bash
|
||||
cd /home/lenovo/zip/vibe-coding-cn/assets/repo/Skill_Seekers-development
|
||||
cd /home/lenovo/zip/vibe-coding-cn/assets/repos/Skill_Seekers-development
|
||||
# 准备 Python 环境（如未安装）
|
||||
uv tool install skill-seekers # 或 pip install skill-seekers
|
||||
|
||||
|
||||
@@ -20,8 +20,8 @@
|
||||
tmux -V
|
||||
|
||||
# 2) 软链配置（不会覆盖已有 .tmux.conf.local，如需自定义请编辑该文件）
|
||||
ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repo/.tmux/.tmux.conf ~/.tmux.conf
|
||||
cp -n /home/lenovo/zip/vibe-coding-cn/assets/repo/.tmux/.tmux.conf.local ~/.tmux.conf.local
|
||||
ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf ~/.tmux.conf
|
||||
cp -n /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf.local ~/.tmux.conf.local
|
||||
|
||||
# 3) 启动会话并验证前缀
|
||||
tmux new -s demo -n shell
|
||||
|
||||
@@ -10,5 +10,5 @@
|
||||
## Notes
|
||||
|
||||
- 长文档、脚本细节放这里，`SKILL.md` 只保留可立即执行的片段。
|
||||
- 配置来源：仓库内 `assets/repo/.tmux`（gpakosz/oh-my-tmux）。
|
||||
- 大规模文档抓取/刷新可用 `assets/repo/Skill_Seekers-development`，示例见 `examples.md`。
|
||||
- 配置来源：仓库内 `assets/repos/.tmux`（gpakosz/oh-my-tmux）。
|
||||
- 大规模文档抓取/刷新可用 `assets/repos/Skill_Seekers-development`，示例见 `examples.md`。
|
||||
|
||||
Reference in New Issue
Block a user