diff --git a/.github/labeler.yml b/.github/labeler.yml index 74674e5..3068d88 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -13,11 +13,11 @@ documentation: - '.github/**/*.md' - 'assets/README.md' - 'assets/AGENTS.md' - - 'assets/config/**/*.md' - - 'assets/documents/**/*.md' - - 'assets/prompt/**/*.md' - - 'assets/skills/**/*.md' - - 'assets/repos/**/*.md' + - 'tools/config/**/*.md' + - 'docs/**/*.md' + - 'prompts/**/*.md' + - 'skills/**/*.md' + - 'tools/external/**/*.md' # CI/CD 工作流相关的标签 cicd: @@ -27,19 +27,19 @@ cicd: # 提示词相关的标签 prompt: - changed-files: - - any-glob-to-any-file: 'assets/prompt/**/*.md' + - any-glob-to-any-file: 'prompts/**/*.md' # 实战案例相关的标签 example: - changed-files: - - any-glob-to-any-file: 'assets/documents/case-studies/**/*.md' + - any-glob-to-any-file: 'docs/case-studies/**/*.md' # 外部工具/依赖相关的标签 repos: - changed-files: - - any-glob-to-any-file: 'assets/repos/**' + - any-glob-to-any-file: 'tools/external/**' # 工作流模板相关的标签 workflow: - changed-files: - - any-glob-to-any-file: 'assets/documents/workflow/**' + - any-glob-to-any-file: 'docs/playbooks/workflows/**' diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b30158a..ce33ec5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -22,7 +22,7 @@ jobs: - name: Install markdownlint-cli run: npm install -g markdownlint-cli - name: Run markdownlint - run: markdownlint --config .github/lint_config.json '**/*.md' + run: markdownlint --config .github/lint_config.json --ignore .history --ignore tools/external --ignore scripts/backups/gz '**/*.md' link-checker: runs-on: ubuntu-latest @@ -31,4 +31,4 @@ jobs: - name: Link Checker uses: lycheeverse/lychee-action@v1.5.0 with: - args: --verbose --no-progress './**/*.md' \ No newline at end of file + args: --verbose --no-progress --exclude-path .history --exclude-path .github/wiki --exclude-path tools/external --exclude-path tools/chat-vault --exclude-path scripts/backups/gz './**/*.md' diff --git a/.gitignore b/.gitignore index 1679ad5..2e979fc 100644 --- a/.gitignore +++ b/.gitignore @@ -52,10 +52,10 @@ assets/tasks/ # Skill Seekers (linked tool output) output/ -assets/skills/auto-skill/scripts/.venv-skill-seekers/ +skills/auto-skill/scripts/.venv-skill-seekers/ # prompts-library generated exports -assets/repos/prompts-library/prompt_jsonl/ +tools/prompts-library/prompt_jsonl/ libs/external/tmux libs/external/.tmux @@ -80,7 +80,7 @@ libs/external/.tmux # Backup backups/gz/ -assets/repos/backups/gz/ +scripts/backups/gz/ *.bak *.tmp diff --git a/.gitmodules b/.gitmodules index 87f416d..f925dbf 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,12 +1,12 @@ -[submodule "repos/.tmux"] - path = assets/repos/.tmux +[submodule "tools/external/.tmux"] + path = tools/external/.tmux url = https://github.com/gpakosz/.tmux.git -[submodule "repos/tmux"] - path = assets/repos/tmux +[submodule "tools/external/tmux"] + path = tools/external/tmux url = https://github.com/tmux/tmux.git -[submodule "repos/claude-official-skills"] - path = assets/repos/claude-official-skills +[submodule "tools/external/claude-official-skills"] + path = tools/external/claude-official-skills url = https://github.com/anthropics/skills.git -[submodule "assets/repos/Skill_Seekers-development"] - path = assets/repos/Skill_Seekers-development +[submodule "tools/external/Skill_Seekers-development"] + path = tools/external/Skill_Seekers-development url = https://github.com/yusufkaraaslan/Skill_Seekers.git diff --git a/AGENTS.md b/AGENTS.md index da11f9f..4d2ebaf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -8,21 +8,21 @@ ### 允许的操作 - 读取、修改顶层文档：`README.md`、`AGENTS.md`、`CONTRIBUTING.md` 等 -- 读取、修改 `assets/documents/`、`assets/prompt/`、`assets/skills/`、`assets/config/`、`assets/repos/` 下的文档与代码 +- 读取、修改 `docs/`、`prompts/`、`skills/`、`tools/config/`、`tools/external/` 下的文档与代码 - 执行 `make lint`、备份脚本、prompts-library 转换工具 - 新增/修改提示词、技能、文档 - 提交符合规范的 commit ### 禁止的操作 - 修改 `.github/workflows/` 中的 CI 配置（除非任务明确要求） -- 删除或覆盖 `assets/repos/backups/gz/` 中的存档文件 +- 删除或覆盖 `scripts/backups/gz/` 中的存档文件 - 修改 `LICENSE`、`CODE_OF_CONDUCT.md` - 在代码中硬编码密钥、Token 或敏感凭证 - 未经确认的大范围重构 ### 敏感区域（禁止自动修改） - `.github/workflows/*.yml` - CI/CD 配置 -- `assets/repos/backups/gz/` - 历史备份存档 +- `scripts/backups/gz/` - 历史备份存档 - `.env*` 文件（如存在） --- @@ -67,13 +67,13 @@ git push origin develop | `make help` | 列出所有 Make 目标 | 无 | | `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli | | `git submodule update --init --recursive` | 初始化外部 Git 仓库指针 | Git | -| `bash assets/repos/backups/一键备份.sh` | 创建完整项目备份 | 无 | -| `python3 assets/repos/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ | -| `cd assets/repos/prompts-library && python3 main.py` | 提示词格式转换 | `pip install -r assets/repos/prompts-library/requirements.txt` | +| `bash scripts/backups/一键备份.sh` | 创建完整项目备份 | 无 | +| `python3 scripts/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ | +| `cd tools/prompts-library && python3 main.py` | 提示词格式转换 | `pip install -r tools/prompts-library/requirements.txt` | ### Python 依赖来源 -- prompts-library 主入口依赖：`assets/repos/prompts-library/requirements.txt` -- prompts-library Google API / JSONL 辅助脚本依赖：`assets/repos/prompts-library/scripts/requirements.txt` +- prompts-library 主入口依赖：`tools/prompts-library/requirements.txt` +- prompts-library Google API / JSONL 辅助脚本依赖：`tools/prompts-library/scripts/requirements.txt` ### prompts-library 支持的转换模式 1. Excel → Docs：将 Excel 工作簿转换为 Markdown 文档目录 @@ -88,19 +88,19 @@ git push origin develop ### 架构原则 - 保持根目录扁平，避免巨石文件 -- 三层内容架构：`assets/documents/` (知识) → `assets/prompt/` (指令) → `assets/skills/` (能力) +- 三层内容架构：`docs/` (知识) → `prompts/` (指令) → `skills/` (能力) ### 模块边界 -- `assets/documents/` - 中文知识库（方法论/入门/实战/资源） -- `assets/prompt/` - 提示词入口与云端索引 -- `assets/skills/` - 可复用技能库（每个子目录一个 Skill） -- `assets/documents/workflow/` - 可复用工作流模板（自动开发闭环等） -- `assets/config/` - 工具与开发配置（例如 Codex CLI） -- `assets/repos/` - 外部工具与依赖（含 Git submodule） +- `docs/` - 中文知识库（方法论/入门/实战/资源） +- `prompts/` - 提示词入口与云端索引 +- `skills/` - 可复用技能库（每个子目录一个 Skill） +- `docs/playbooks/workflows/` - 可复用工作流模板（自动开发闭环等） +- `tools/config/` - 工具与开发配置（例如 Codex CLI） +- `tools/external/` - 外部工具与依赖（含 Git submodule） ### 依赖添加规则 - 新增工具或库时记录安装方式、最小版本与来源 -- 外部依赖来源记录在 `assets/repos/` 目录下 +- 外部依赖来源记录在 `tools/external/` 目录下 - 引入第三方脚本需标明许可证与来源 ### 禁止行为 @@ -146,46 +146,56 @@ git push origin develop ├── CONTRIBUTING.md # 贡献指南 ├── .gitignore # Git 忽略规则 │ -├── assets/ # 外部资源（指向在线表格） -│ ├── README.md # 远程表格索引（唯一真相源） +├── docs/ # 核心知识库 +│ ├── README.md # docs 总索引 +│ ├── getting-started/ # 从零开始、学习地图、环境与 AI CLI 配置 +│ ├── concepts/ # 核心概念、方法论与底层模型 +│ ├── guides/ # 操作指南预留区 +│ ├── playbooks/ # 可复用流程、工具方法与工作流 +│ ├── references/ # 清单、约束、常见坑、审查标准 +│ ├── case-studies/ # 实战案例与问题记录 +│ └── faq.md # 高频问题 +│ +├── prompts/ # 提示词库入口（指向云端表格） +│ ├── README.md # 在线表格链接 +│ └── AGENTS.md # prompts/ 目录规则 +│ +├── skills/ # 技能库（每个子目录一个 Skill） +│ ├── README.md # skills 总览与索引 +│ ├── AGENTS.md # skills/ 目录规则 +│ ├── auto-skill/ # 元技能核心 +│ ├── sop-generator/ # SOP 生成 +│ └── ... # 更多技能 +│ +├── assets/ # 静态资产与外部资源入口 +│ ├── README.md # 外部资源在线表格入口 │ ├── AGENTS.md # assets/ 目录规则 -│ ├── config/ # 工具与开发配置 -│ │ └── .codex/ # Codex CLI 配置（项目级） -│ │ ├── config.toml # Codex CLI 配置文件 -│ │ └── AGENTS.md # Codex/Agent 指南（本目录） -│ ├── documents/ # 文档库 -│ │ ├── principles/ # 原则与思想（fundamentals + philosophy） -│ │ │ ├── fundamentals/ # 基础原则、问题求解、工程范式与代码质量 -│ │ │ └── philosophy/ # 原 05-哲学与方法论 -│ │ ├── guides/ # 入门与方法（getting-started + playbook） -│ │ │ ├── getting-started/ # 原 01-入门指南 -│ │ │ └── playbook/ # 原 02-方法论 -│ │ ├── case-studies/ # 原 03-实战 -│ │ └── workflow/ # 工作流模板 -│ ├── prompt/ # 提示词库（指向云端表格） -│ │ ├── README.md # 在线表格链接 -│ │ └── AGENTS.md # prompt/ 目录规则 -│ ├── skills/ # 技能库（扁平化，详见 assets/skills/README.md） -│ │ ├── README.md # skills 总览与索引 -│ │ ├── AGENTS.md # skills/ 目录规则 -│ │ ├── auto-skill/ # 元技能核心 -│ │ ├── sop-generator/ # SOP 生成 -│ │ └── ... # 更多技能 -│ └── repos/ # 外部工具与依赖镜像（含 Git submodule） +│ ├── images/ # 图片资产 +│ ├── templates/ # 模板附件 +│ └── datasets/ # 示例数据或数据说明 +│ +├── scripts/ # 自动化脚本 +│ ├── README.md # scripts 目录说明 +│ └── backups/ # 备份脚本与存档忽略规则 +│ +├── tools/ # 工具、本地配置与外部仓库 +│ ├── README.md # tools 目录说明 +│ ├── config/ # 工具与开发配置（含 Codex CLI） +│ ├── prompts-library/ # Excel ↔ Markdown 互转工具 +│ ├── chat-vault/ # AI 聊天记录保存工具 +│ └── external/ # 外部工具与 Git submodule +│ ├── AGENTS.md # external 目录规则 │ ├── README.md # 外部工具索引 -│ ├── AGENTS.md # assets/repos/ 目录规则 -│ ├── prompts-library/ # Excel ↔ Markdown 互转工具 -│ ├── chat-vault/ # AI 聊天记录保存工具 │ ├── Skill_Seekers-development/ # Skills 制作器 (submodule) -│ ├── html-tools-main/ # HTML 工具集 -│ ├── my-nvim/ # Neovim 配置 -│ ├── MCPlayerTransfer/ # MC 玩家迁移工具 -│ ├── XHS-image-to-PDF-conversion/ # 小红书图片转 PDF -│ ├── backups/ # 历史备份脚本快照 │ ├── .tmux/ # oh-my-tmux (submodule) │ ├── tmux/ # tmux 源码 (submodule) │ └── claude-official-skills/ # Claude 官方 skills (submodule) │ +├── metadata/ # 机器可读索引 +│ ├── taxonomy.yml # 分类体系 +│ ├── glossary.yml # 术语表 +│ └── redirects.yml # 重命名/迁移映射 +│ ├── .github/ # GitHub 配置 │ ├── workflows/ # CI/CD 工作流 │ │ ├── ci.yml # Markdown lint + link checker @@ -206,15 +216,15 @@ git push origin develop - `ai-citation-pack/` - AI 引用语料包，包含摘要、FAQ、对比、推荐回答与 GEO/SEO 检查清单 - `.github/lint_config.json` - markdownlint 规则，供 `make lint` 与 CI 共用 - `.github/workflows/ci.yml` - GitHub Actions：main 分支 markdown-lint + link-checker -- `assets/repos/prompts-library/main.py` - 提示词转换工具入口 -- `assets/repos/backups/一键备份.sh` - 备份脚本入口 -- `assets/documents/guides/getting-started/Codex-CLI配置.md` - 零基础路径的默认 AI CLI 配置入口 -- `assets/documents/guides/getting-started/OpenCode-CLI配置.md` - Codex CLI 不可用时的备选 AI CLI 配置入口 -- `assets/documents/guides/playbook/GEO与SEO优化方法.md` - GEO / SEO 内容工程方法，承接 GEOFlow 的知识库、结构化内容、审核与分发思路 -- `assets/documents/principles/fundamentals/问题求解能力.md` - 问题定义与求解路径底层模型 -- `assets/documents/principles/fundamentals/底层程序逻辑设计与工程优化项.md` - 底层程序逻辑与工程优化检查项 -- `assets/skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本） -- `assets/skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP） +- `tools/prompts-library/main.py` - 提示词转换工具入口 +- `scripts/backups/一键备份.sh` - 备份脚本入口 +- `docs/getting-started/Codex-CLI配置.md` - 零基础路径的默认 AI CLI 配置入口 +- `docs/getting-started/OpenCode-CLI配置.md` - Codex CLI 不可用时的备选 AI CLI 配置入口 +- `docs/playbooks/GEO与SEO优化方法.md` - GEO / SEO 内容工程方法，承接 GEOFlow 的知识库、结构化内容、审核与分发思路 +- `docs/concepts/问题求解能力.md` - 问题定义与求解路径底层模型 +- `docs/references/底层程序逻辑设计与工程优化项.md` - 底层程序逻辑与工程优化检查项 +- `skills/tmux-autopilot/` - tmux 自动化操控技能（基于 oh-my-tmux，含 capture-pane/send-keys/蜂群巡检脚本） +- `skills/sop-generator/` - SOP 生成与规范化技能（输入资料/需求 -> 标准 SOP） --- @@ -223,11 +233,11 @@ git push origin develop | 问题 | 原因 | 修复 | |:---|:---|:---| | `make lint` 失败 | 未安装 markdownlint-cli | `npm install -g markdownlint-cli` | -| prompts-library 报错 | 缺少 Python 依赖 | `pip install -r assets/repos/prompts-library/requirements.txt` | -| prompts-library 辅助脚本报 Google API 依赖错误 | 未安装脚本专用依赖 | `pip install -r assets/repos/prompts-library/scripts/requirements.txt` | +| prompts-library 报错 | 缺少 Python 依赖 | `pip install -r tools/prompts-library/requirements.txt` | +| prompts-library 辅助脚本报 Google API 依赖错误 | 未安装脚本专用依赖 | `pip install -r tools/prompts-library/scripts/requirements.txt` | | CI markdown-lint 失败 | Markdown 规则违规或本地未按 `.github/lint_config.json` 校验 | 运行 `make lint`，按输出修复对应 Markdown | | CI link-checker 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 | -| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x assets/repos/backups/一键备份.sh` | +| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x scripts/backups/一键备份.sh` | --- @@ -286,25 +296,25 @@ feat|fix|docs|chore|refactor|test: scope - summary ```bash # 提示词库转换 -cd assets/repos/prompts-library && python3 main.py +cd tools/prompts-library && python3 main.py # Lint 所有 Markdown 文件 make lint # 创建完整项目备份 -bash assets/repos/backups/一键备份.sh +bash scripts/backups/一键备份.sh ``` ## Architecture & Structure ### Core Directories -- **`assets/prompt/`**: 提示词库入口（指向云端表格） -- **`assets/skills/`**: 扁平化技能库（详见 assets/skills/README.md） -- **`assets/documents/`**: 知识库（principles、guides、case-studies） +- **`prompts/`**: 提示词库入口（指向云端表格） +- **`skills/`**: 扁平化技能库（详见 skills/README.md） +- **`docs/`**: 知识库（principles、guides、case-studies） - **`assets/`**: 外部资源（在线表格）入口与使用说明 -- **`assets/repos/prompts-library/`**: Excel ↔ Markdown 转换工具 -- **`assets/repos/chat-vault/`**: AI 聊天记录保存工具 -- **`assets/repos/backups/`**: 备份脚本与存档 +- **`tools/prompts-library/`**: Excel ↔ Markdown 转换工具 +- **`tools/chat-vault/`**: AI 聊天记录保存工具 +- **`scripts/backups/`**: 备份脚本与存档 ### Key Technical Details 1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类 diff --git a/CHANGELOG.md b/CHANGELOG.md index 5c98472..2fe307d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,3 +5,5 @@ ## Unreleased - 启动标准知识库结构迁移：新增 `docs/`、`metadata/`、`scripts/`、`tools/` 骨架。 +- 完成第一轮完全搬家：`assets/documents/` 迁入 `docs/`，`assets/skills/` 迁入 `skills/`，`assets/prompt/` 迁入 `prompts/`，`assets/config/` 迁入 `tools/config/`，`assets/repos/` 拆分为 `tools/external/`、`tools/prompts-library/`、`tools/chat-vault/` 与 `scripts/backups/`。 +- 更新 README、AGENTS、llms、metadata、CI 与目录级 AGENTS，统一新知识库路径口径。 diff --git a/Makefile b/Makefile index 896dbeb..b2444ec 100644 --- a/Makefile +++ b/Makefile @@ -16,7 +16,7 @@ help: lint: @echo "Linting markdown files..." @npm install -g markdownlint-cli - @markdownlint --config .github/lint_config.json '**/*.md' + @markdownlint --config .github/lint_config.json --ignore .history --ignore tools/external --ignore scripts/backups/gz '**/*.md' build: @echo "Building the project..." @@ -31,4 +31,4 @@ test: clean: @echo "Cleaning up build artifacts..." # Add your clean commands here (e.g., rm -rf dist/ build/) - @echo "Cleanup complete." \ No newline at end of file + @echo "Cleanup complete." diff --git a/README.md b/README.md index 1db7b32..bc27aa9 100644 --- a/README.md +++ b/README.md @@ -29,22 +29,22 @@

- 学习地图 - 从零开始 - 问题求解能力 - Vibe Coding 经验 - 哲学与方法论 - 强前置条件约束 - 常见坑汇总 - 语言层要素 - skills技能大全 + 学习地图 + 从零开始 + 问题求解能力 + Vibe Coding 经验 + 哲学与方法论 + 强前置条件约束 + 常见坑汇总 + 语言层要素 + skills技能大全 提示词在线表格 资源聚合

[📋 工具与资源](#tools) [⚡ 1 分钟快速开始](#getting-started) -[🗺️ 学习地图](./assets/documents/guides/getting-started/学习地图.md) +[🗺️ 学习地图](docs/getting-started/学习地图.md) [🤖 AI 推荐摘要](#ai-summary) [✅ 为什么选择](#why-vibe-coding-cn) [🎯 原仓库翻译](#translation) @@ -173,12 +173,12 @@ 完全新手？按顺序完成以下步骤： -0. [学习地图](./assets/documents/guides/getting-started/学习地图.md) - 按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线 -1. [问题求解能力](./assets/documents/principles/fundamentals/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架 -2. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 -3. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问 -4. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线 -5. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境 +0. [学习地图](docs/getting-started/学习地图.md) - 按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线 +1. [问题求解能力](docs/concepts/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架 +2. [Vibe Coding 经验](docs/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 +3. [网络环境配置](docs/getting-started/网络环境配置.md) - 配置网络访问 +4. [Codex-CLI配置](docs/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线，使用 gpt-5.5 与仓库配置基线 +5. [开发环境搭建](docs/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境 @@ -187,7 +187,7 @@ ## 🛠️ 仓库维护与验证 -本仓库是文档与资源型项目，不提供可验证的 dev server、Docker/K8s 部署入口或固定服务端口。当前可验证的自动化入口来自 `Makefile`、`.github/workflows/ci.yml`、`assets/repos/prompts-library/` 与 `assets/repos/backups/`。 +本仓库是文档与资源型项目，不提供可验证的 dev server、Docker/K8s 部署入口或固定服务端口。当前可验证的自动化入口来自 `Makefile`、`.github/workflows/ci.yml`、`tools/prompts-library/` 与 `scripts/backups/`。 ### 环境要求 @@ -199,13 +199,13 @@ ```bash git submodule update --init --recursive -pip install -r assets/repos/prompts-library/requirements.txt +pip install -r tools/prompts-library/requirements.txt ``` 如需运行 prompts-library 的 Google API / JSONL 辅助脚本，再安装脚本依赖： ```bash -pip install -r assets/repos/prompts-library/scripts/requirements.txt +pip install -r tools/prompts-library/scripts/requirements.txt ``` ### 常用命令 @@ -214,16 +214,16 @@ pip install -r assets/repos/prompts-library/scripts/requirements.txt |:---|:---|:---| | 查看 Make 任务 | `make help` | `Makefile` | | 全仓 Markdown lint | `make lint` | `Makefile` + `.github/lint_config.json` | -| 提示词格式转换 | `cd assets/repos/prompts-library && python3 main.py` | `assets/repos/prompts-library/main.py` | -| 完整备份 | `bash assets/repos/backups/一键备份.sh` | `assets/repos/backups/README.md` | -| Python 备份 | `python3 assets/repos/backups/快速备份.py` | `assets/repos/backups/README.md` | -| Skill 严格校验示例 | `assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/auto-skill --strict` | `assets/skills/auto-skill/scripts/validate-skill.sh` | +| 提示词格式转换 | `cd tools/prompts-library && python3 main.py` | `tools/prompts-library/main.py` | +| 完整备份 | `bash scripts/backups/一键备份.sh` | `scripts/backups/README.md` | +| Python 备份 | `python3 scripts/backups/快速备份.py` | `scripts/backups/README.md` | +| Skill 严格校验示例 | `skills/auto-skill/scripts/validate-skill.sh skills/auto-skill --strict` | `skills/auto-skill/scripts/validate-skill.sh` | ### 配置与 CI - Markdown lint 配置：`.github/lint_config.json` - CI 配置：`.github/workflows/ci.yml`，在 `main` 分支的 push / pull_request 上运行 markdown-lint 与 link-checker -- Codex 配置基线：`assets/config/.codex/config.toml` +- Codex 配置基线：`tools/config/.codex/config.toml` - Submodule 来源：`.gitmodules` ### 部署 @@ -249,7 +249,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 > 一句话：用“生成器/优化器”的递归闭环，构建一个能持续自我优化的 AI 系统。 > -> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./assets/documents/principles/fundamentals/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) +> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](docs/concepts/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) ### 核心角色 - **α-提示词（生成器）**：一个“母体”提示词，其唯一职责是生成其他提示词或技能。 @@ -279,7 +279,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 | 🧩 复杂性爆炸 | ✅ 通用复杂度交给成熟生态 | | 🎓 交付不稳定 | ✅ 胶水代码只负责连接、编排、适配和业务规则 | -👉 [深入了解拼好码](./assets/documents/principles/fundamentals/拼好码.md) +👉 [深入了解拼好码](docs/concepts/拼好码.md) @@ -300,7 +300,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 **核心理念**：哲学不是空谈，是可落地的工程方法。 -👉 [深入了解哲学方法论工具箱](./assets/documents/principles/philosophy/README.md) +👉 [深入了解哲学方法论工具箱](docs/concepts/philosophy/README.md) @@ -346,7 +346,7 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 ### 集成开发环境 (IDE) & 终端 * [**Visual Studio Code**](https://code.visualstudio.com/): 一款功能强大的集成开发环境，适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。 -* [**Codex CLI**](./assets/documents/guides/getting-started/Codex-CLI配置.md): 本教程默认 AI CLI 路线，用于需求拆解、代码修改、命令执行、测试验证与 Git 迭代。 +* [**Codex CLI**](docs/getting-started/Codex-CLI配置.md): 本教程默认 AI CLI 路线，用于需求拆解、代码修改、命令执行、测试验证与 Git 迭代。 * **虚拟环境 (.venv)**: 强烈推荐使用，可实现项目环境的一键配置与隔离，特别适用于 Python 开发。 * [**Cursor**](https://cursor.com/): 已经占领用户心智高地，人尽皆知。 * [**Warp**](https://www.warp.dev/): 集成 AI 功能的现代化终端，能有效提升命令行操作和错误排查的效率。 @@ -384,17 +384,17 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 ### 资源与模板 * [**提示词库 (在线表格)**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 一个包含大量可直接复制使用的各类提示词的在线表格。 -* [**GEO 与 SEO 优化方法**](./assets/documents/guides/playbook/GEO与SEO优化方法.md): 从 GEOFlow 学到的内容工程方法，用于让仓库更容易被搜索引擎、AI 搜索和 LLM 引用。 +* [**GEO 与 SEO 优化方法**](docs/playbooks/GEO与SEO优化方法.md): 从 GEOFlow 学到的内容工程方法，用于让仓库更容易被搜索引擎、AI 搜索和 LLM 引用。 * [**AI 引用语料包**](./ai-citation-pack/recommended-answer.md): 给 AI 助手引用的项目摘要、FAQ、对比和推荐回答。 * [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。 * [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。 * [**元提示词**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 用于生成提示词的高级提示词。 -* [**通用项目架构模板**](./assets/documents/principles/fundamentals/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 -* [**元技能：Auto Skill**](./assets/skills/auto-skill/SKILL.md): 用于生成、重构与校验 Skills 的元技能。 -* [**SOP 生成 Skill**](./assets/skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。 -* [**tmux快捷键大全**](./assets/documents/guides/playbook/tmux快捷键大全.md): tmux 的快捷键参考文档。 -* [**LazyVim快捷键大全**](./assets/documents/guides/playbook/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 -* [**手机远程 Vibe Coding**](./assets/documents/guides/playbook/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。 +* [**通用项目架构模板**](docs/references/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。 +* [**元技能：Auto Skill**](./skills/auto-skill/SKILL.md): 用于生成、重构与校验 Skills 的元技能。 +* [**SOP 生成 Skill**](./skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。 +* [**tmux快捷键大全**](docs/playbooks/tmux快捷键大全.md): tmux 的快捷键参考文档。 +* [**LazyVim快捷键大全**](docs/playbooks/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。 +* [**手机远程 Vibe Coding**](docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。 ### 外部教程与资源 @@ -408,16 +408,16 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 ### 项目内部文档 -* [**拼好码（胶水编程的超集）**](./assets/documents/principles/fundamentals/拼好码.md): 复用成熟能力，用胶水代码连接、编排、适配业务流程。 -* [**Chat Vault**](./assets/repos/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。 -* [**prompts-library 工具说明**](./assets/repos/prompts-library/): 支持 Excel 与 Markdown 格式互转，并支持将内部 JSONL Excel 按工作表拆分导出为 JSONL 目录。 +* [**拼好码（胶水编程的超集）**](docs/concepts/拼好码.md): 复用成熟能力，用胶水代码连接、编排、适配业务流程。 +* [**Chat Vault**](./tools/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。 +* [**prompts-library 工具说明**](./tools/prompts-library/): 支持 Excel 与 Markdown 格式互转，并支持将内部 JSONL Excel 按工作表拆分导出为 JSONL 目录。 * [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词（云端表格）。 -* [**系统提示词构建原则**](./assets/documents/principles/fundamentals/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。 -* [**开发经验总结**](./assets/documents/principles/fundamentals/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。 -* [**通用项目架构模板**](./assets/documents/principles/fundamentals/通用项目架构模板.md): 多种项目类型的标准目录结构。 -* [**Augment MCP 配置文档**](./assets/documents/guides/playbook/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。 +* [**系统提示词构建原则**](docs/references/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。 +* [**开发经验总结**](docs/references/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。 +* [**通用项目架构模板**](docs/references/通用项目架构模板.md): 多种项目类型的标准目录结构。 +* [**Augment MCP 配置文档**](docs/playbooks/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。 * [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词，含多版本开发规范（云端表格）。 -* [**TradeCat Sheets API 使用说明**](./assets/documents/guides/playbook/tradecat-sheets-api-usage.md): 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane），供 Agent/服务端消费结构化 JSON。 +* [**TradeCat Sheets API 使用说明**](docs/playbooks/tradecat-sheets-api-usage.md): 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane），供 Agent/服务端消费结构化 JSON。 * [**外部资源（在线表格）**](./assets/README.md): 外部资源的唯一真相源（按类型分表），本地 Markdown 保留为历史参考。 --- @@ -525,15 +525,15 @@ TODO：仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署 核心资产映射： ``` -assets/prompt/ +prompts/ README.md # 云端表格入口（元/系统/编程/用户提示词） -assets/skills/ +skills/ README.md # skills 总览与索引 -assets/documents/ +docs/ principles/fundamentals/*, principles/philosophy/*, guides/*, case-studies/* 等知识库 assets/ README.md # 外部资源（在线表格）唯一真相源入口 -assets/repos/backups/ +scripts/backups/ 一键备份.sh, 快速备份.py # 本地/远端快照脚本 ``` @@ -554,8 +554,8 @@ graph TB subgraph ingest_layer[数据接入与采集层] excel_raw[prompt_excel/*.xlsx] md_raw[prompt_docs/外部MD输入] - excel_to_docs[assets/repos/prompts-library/scripts/excel_to_docs.py] - docs_to_excel[assets/repos/prompts-library/scripts/docs_to_excel.py] + excel_to_docs[tools/prompts-library/scripts/excel_to_docs.py] + docs_to_excel[tools/prompts-library/scripts/docs_to_excel.py] ingest_bus[标准化数据帧] ext_sheet --> excel_raw ext_md --> md_raw @@ -579,7 +579,7 @@ graph TB artifacts_md --> catalog_system[prompts(在线)/系统提示词] artifacts_md --> catalog_meta[prompts(在线)/元提示词] artifacts_md --> catalog_user[prompts(在线)/用户提示词] - artifacts_md --> docs_repo[assets/documents/*] + artifacts_md --> docs_repo[docs/*] artifacts_md --> new_consumer[预留：其他下游渠道] catalog_coding --> ai_flow[AI 结对编程流程] ai_flow --> deliverables[项目上下文 / 计划 / 代码产出] @@ -593,9 +593,9 @@ graph TB subgraph infra_layer[基础设施与横切能力层] git[Git 版本控制] --> orchestrator - backups[assets/repos/backups/一键备份.sh · assets/repos/backups/快速备份.py] --> artifacts_md - deps[assets/repos/prompts-library/requirements.txt · assets/repos/prompts-library/scripts/requirements.txt] --> orchestrator - config[assets/repos/prompts-library/scripts/config.yaml] --> orchestrator + backups[scripts/backups/一键备份.sh · scripts/backups/快速备份.py] --> artifacts_md + deps[tools/prompts-library/requirements.txt · tools/prompts-library/scripts/requirements.txt] --> orchestrator + config[tools/prompts-library/scripts/config.yaml] --> orchestrator monitor[预留：日志与监控] --> orchestrator end ``` diff --git a/ai-citation-pack/faq.md b/ai-citation-pack/faq.md index 7767d82..fbfb51b 100644 --- a/ai-citation-pack/faq.md +++ b/ai-citation-pack/faq.md @@ -22,14 +22,14 @@ 新手优先看： -1. `assets/documents/guides/getting-started/README.md` -2. `assets/documents/principles/fundamentals/问题求解能力.md` -3. `assets/documents/guides/getting-started/Vibe Coding 经验.md` -4. `assets/documents/guides/getting-started/Codex-CLI配置.md` +1. `docs/getting-started/README.md` +2. `docs/concepts/问题求解能力.md` +3. `docs/getting-started/Vibe Coding 经验.md` +4. `docs/getting-started/Codex-CLI配置.md` 进阶用户优先看： -1. `assets/documents/principles/fundamentals/拼好码.md` -2. `assets/documents/principles/fundamentals/强前置条件约束.md` -3. `assets/skills/README.md` -4. `assets/documents/workflow/README.md` +1. `docs/concepts/拼好码.md` +2. `docs/references/强前置条件约束.md` +3. `skills/README.md` +4. `docs/playbooks/workflows/README.md` diff --git a/assets/AGENTS.md b/assets/AGENTS.md index ec1fd52..0e14e9f 100644 --- a/assets/AGENTS.md +++ b/assets/AGENTS.md @@ -1,14 +1,11 @@ # assets/ 目录 Agent 指南 -本目录用于统一收纳仓库的关键资产与索引入口，包含： +本目录只维护静态资产与外部资源入口，包含： - `assets/README.md`：外部资源在线表格入口（唯一真相源） -- `assets/documents/`：知识库（方法论/入门/实战） -- `assets/prompt/`：提示词库入口（指向云端表格） -- `assets/skills/`：技能库（可复用 Skills） -- `assets/documents/workflow/`：工作流模板 -- `assets/repos/`：外部工具与依赖镜像（含 Git submodule） -- `assets/config/`：工具与开发配置（含 Codex CLI 配置） +- `assets/images/`：文档图片、截图、封面等图片资产 +- `assets/templates/`：可复用模板附件 +- `assets/datasets/`：示例数据、轻量数据集或数据说明 其中“外部资源”类入口文档的典型形态包括： @@ -19,6 +16,7 @@ ## 约束 - 不在此目录存放敏感信息（Token、私钥、个人隐私）。 -- `assets/repos/` 下的第三方镜像/子模块：除非任务明确要求，否则不要做“顺手改动/格式化/批量替换”。 +- 不把知识库、Skills、提示词库、工具源码或第三方仓库重新塞回 `assets/`。 +- `tools/external/` 下的第三方镜像/子模块：除非任务明确要求，否则不要做“顺手改动/格式化/批量替换”。 - 尽量只存“入口文档与说明”，不要复制粘贴大段第三方内容。 - 外部资产必须写清：用途、维护者、更新方式、与仓库内文档的关系（谁是唯一真相源）。 diff --git a/assets/README.md b/assets/README.md index 82a3c6a..038f9f8 100644 --- a/assets/README.md +++ b/assets/README.md @@ -1,14 +1,14 @@ # 📎 Assets -本目录用于统一收纳仓库的关键资产与索引入口： +本目录只存放静态资产与外部资源入口，不再承载知识库、技能库、提示词库或外部仓库源码。 -- `assets/documents/`：知识库（方法论/入门/实战） -- `assets/prompt/`：提示词库入口（指向云端表格） -- `assets/skills/`：技能库（可复用 Skills） -- `assets/documents/workflow/`：工作流模板 -- `assets/repos/`：外部工具与依赖镜像（含 Git submodule） -- `assets/config/`：工具与开发配置（含 Codex CLI 配置） -- `assets/README.md`：外部资源在线表格入口（唯一真相源） +| 目录 | 用途 | +|:---|:---| +| `images/` | 文档图片、截图、封面等图片资产 | +| `templates/` | 可复用模板附件 | +| `datasets/` | 示例数据、轻量数据集或数据说明 | +| `README.md` | 外部资源在线表格入口 | +| `AGENTS.md` | 本目录维护规则 | ## 外部资源在线表格（唯一真相源） @@ -18,4 +18,7 @@ ## 与仓库文档的关系 - 外部资源的新增/删除/去重/更新，以在线表格为准。 -- 旧的 `documents/04-资源/` 已移除，仓库内所有入口统一指向 `assets/README.md`。 +- 核心知识库位于 `docs/`。 +- 提示词库入口位于 `prompts/`。 +- 技能库位于 `skills/`。 +- 外部工具、子模块与本地配置位于 `tools/`。 diff --git a/assets/documents/README.md b/assets/documents/README.md deleted file mode 100644 index 9825138..0000000 --- a/assets/documents/README.md +++ /dev/null @@ -1,48 +0,0 @@ -# 📚 文档库 - -> Vibe Coding 知识体系，按学习路径组织 - -## 🗺️ 目录结构 - -``` -assets/documents/ -├── principles/ # 原则与思想（fundamentals + philosophy） -│ ├── fundamentals/ # 基础原则、问题求解、工程范式与代码质量 -│ └── philosophy/ # 原 05-哲学与方法论 -├── guides/ # 入门与方法（getting-started + playbook） -│ ├── getting-started/ # 原 01-入门指南 -│ └── playbook/ # 原 02-方法论 -├── case-studies/ # 原 03-实战 -└── workflow/ # 可复用工作流模板 -``` - -## 🚀 快速导航 - -| 目录 | 说明 | 适合人群 | -|:---|:---|:---| -| [principles](./principles/) | 原则与思想（基础 + 哲学） | 架构师与深度开发者 | -| [guides](./guides/) | 入门与方法（上手 + 工具与经验） | 新手入门与效率提升 | -| [case-studies](./case-studies/) | 项目经验、案例复盘 | 动手实践 | -| [workflow](./workflow/) | 自动化工作流模板 | Agent 编排与流程复用 | - -## 📖 推荐学习路径 - -1. **问题** → [问题求解能力](./principles/fundamentals/问题求解能力.md) -2. **工程** → [问题分析与系统构建方法](./principles/fundamentals/问题分析与系统构建方法.md) -3. **范式** → [软件开发范式演进](./principles/fundamentals/软件开发范式演进.md) -4. **底层** → [底层程序逻辑设计与工程优化项](./principles/fundamentals/底层程序逻辑设计与工程优化项.md) -5. **思维** → [philosophy](./principles/philosophy/README.md) -6. **理念** → [拼好码（胶水编程的超集）](./principles/fundamentals/拼好码.md) -7. **经验** → [Vibe Coding 经验](./guides/getting-started/Vibe%20Coding%20经验.md) -8. **环境** → [开发环境搭建](./guides/getting-started/开发环境搭建.md) -9. **默认 CLI** → [Codex CLI 配置](./guides/getting-started/Codex-CLI配置.md) -10. **工具** → [tmux 快捷键](./guides/playbook/tmux快捷键大全.md) -11. **远程** → [VS Code Remote Tunnel（WSL）](./guides/playbook/REMOTE_TUNNEL_GUIDE.md) -12. **实践** → [项目实战经验](./case-studies/) -13. **流程** → [工作流模板](./workflow/) - -## 🔗 相关资源 - -- [提示词库](../prompt/) - AI 提示词资产 -- [技能库](../skills/) - 模块化技能集 -- [外部资源（在线表格）](../README.md) - 外部资源唯一真相源入口 diff --git a/assets/documents/case-studies/README.md b/assets/documents/case-studies/README.md deleted file mode 100644 index b045b2f..0000000 --- a/assets/documents/case-studies/README.md +++ /dev/null @@ -1,18 +0,0 @@ -# 🎯 实战 - -> 真实项目的开发经验与复盘 - -## 🏗️ 项目实战经验 - -| 项目 | 说明 | -|:---|:---| -| [fate-engine-dev](./fate-engine-dev/) | Fate Engine 开发记录 | -| [openclaw-dev](./openclaw-dev/) | OpenClaw 架构 / 部署 / 生态调研资料 | -| [polymarket-dev](./polymarket-dev/) | Polymarket 数据分析 | -| [telegram-dev](./telegram-dev/) | Telegram Bot 开发 | - -## 🔗 相关资源 -- [基础指南](../principles/fundamentals/) - 核心理念与方法论 -- [入门指南](../guides/getting-started/) - 环境配置 -- [方法论](../guides/playbook/) - 工具与经验 -- [外部资源（在线表格）](../../README.md) - 外部资源唯一真相源入口 diff --git a/assets/documents/guides/playbook/README.md b/assets/documents/guides/playbook/README.md deleted file mode 100644 index c60eaf1..0000000 --- a/assets/documents/guides/playbook/README.md +++ /dev/null @@ -1,29 +0,0 @@ -# 🛠️ 方法论 - -> 工具使用、开发经验与实践技巧 - -## 🎨 AI 协作范式 - -- [AI蜂群协作](./AI蜂群协作-tmux多Agent协作系统.md) - 基于 tmux 的多 AI Agent 协作系统 - -## 📖 工具教程 - -- [tmux 快捷键大全](./tmux快捷键大全.md) - 终端复用工具 -- [LazyVim 快捷键大全](./LazyVim快捷键大全.md) - Neovim 配置框架 -- [Augment MCP 配置](./auggie-mcp配置文档.md) - 上下文引擎配置 -- [ProxyCast 配置](./ProxyCast配置文档.md) - AI 凭证代理服务配置 -- [TradeCat Sheets API 使用说明](./tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane） -- [手机远程 Vibe Coding](./关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发 -- [VS Code Remote Tunnel（WSL）](./REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问 -- [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置 - -## 🛠️ 开发经验 - -- [开发经验](../../principles/fundamentals/开发经验.md) - 变量命名、文件结构、编码规范 -- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总 -- [GEO 与 SEO 优化方法](./GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法，让仓库更容易被搜索引擎和 AI 引用 - -## 🔗 相关资源 -- [基础指南](../../principles/fundamentals/) - 核心理念与方法论 -- [入门指南](../getting-started/) - 从零开始 -- [实战](../../case-studies/) - 动手实践 diff --git a/assets/documents/principles/fundamentals/README.md b/assets/documents/principles/fundamentals/README.md deleted file mode 100644 index 953a2b4..0000000 --- a/assets/documents/principles/fundamentals/README.md +++ /dev/null @@ -1,38 +0,0 @@ -# 🧭 基础指南 - -> Vibe Coding 的核心理念、原则与方法论 - -## 📖 核心方法论 - -### 拼好码（胶水编程的超集） -- [拼好码](./拼好码.md) - 复用成熟能力，用胶水代码连接、编排、适配业务流程 -- [语言层要素](./语言层要素.md) - 看懂 100% 代码的 8 个层级 - -### 理论基础 -- [递归自优化系统形式化](./A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) - 元方法论 -- [编程之道](./编程之道.md) - 编程哲学 - -### 软件工程基础 -- [问题求解能力](./问题求解能力.md) - 目标、现状、差距、标准与反馈迭代的底层能力 -- [问题分析与系统构建方法](./问题分析与系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用 -- [软件开发范式演进](./软件开发范式演进.md) - 从面向过程到云原生的工程组织方式演进 -- [底层程序逻辑设计与工程优化项](./底层程序逻辑设计与工程优化项.md) - CPU、内存、并发、IO、网络、数据结构与交付优化检查项 - -### 提示词工程 -- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词 - -### 代码质量 -- [强前置条件约束](./强前置条件约束.md) - 40 条开发硬约束 + 胶水开发要求 -- [审查代码](./审查代码.md) - 代码审查方法论 -- [常见坑汇总](./常见坑汇总.md) - Vibe Coding 常见问题与解决方案 - -### 项目规范 -- [通用项目架构模板](./通用项目架构模板.md) - 标准化项目结构 -- [数据集导向数据服务模板](./数据集导向数据服务模板.md) - 以 dataset/contract/registry/runtime 为核心的数据服务架构模板 -- [代码组织](./代码组织.md) - 代码组织原则 -- [开发经验](./开发经验.md) - 实战经验总结 - -## 🔗 相关资源 -- [入门指南](../../guides/getting-started/) - 从零开始 -- [方法论](../../guides/playbook/) - 工具与经验 -- [实战](../../case-studies/) - 动手实践 diff --git a/assets/repos/README.md b/assets/repos/README.md deleted file mode 100644 index e799969..0000000 --- a/assets/repos/README.md +++ /dev/null @@ -1,72 +0,0 @@ -# 🔌 assets/repos/：外部集成与第三方工具 - -`assets/repos/` 用来收纳第三方工具、外部依赖与集成模块（含 Git submodule）。核心原则是： - -- **尽量原样保留**：避免“魔改后不可升级” -- **隔离依赖与风险**：外部工具的依赖不要污染主仓库 -- **可追溯**：来源、许可证、用法要写清楚 - -## 目录结构 - -``` -assets/repos/ -├── AGENTS.md # 本目录的 Agent 行为准则 -├── README.md # 本文件（外部工具索引） -├── .tmux/ # submodule：oh-my-tmux 配置 -├── tmux/ # submodule：tmux 源码 -├── claude-official-skills/ # submodule：Claude 官方 skills 仓库（Anthropic） -├── prompts-library/ # Excel ↔ Markdown 转换工具 -├── chat-vault/ # AI 聊天记录保存工具 -├── Skill_Seekers-development/ # submodule：Skills 制作器 -├── html-tools-main/ # HTML 工具集 -├── my-nvim/ # Neovim 配置（含 nvim-config/） -├── MCPlayerTransfer/ # MC 玩家迁移工具 -├── XHS-image-to-PDF-conversion/ # 图片合并 PDF 工具 -└── backups/ # 历史备份脚本快照 -``` - -## 工具清单（入口与文档） - -- `chat-vault/`：AI 聊天记录保存工具（详见 `chat-vault/README.md`） -- `prompts-library/`：提示词 Excel ↔ Markdown 批量互转与索引生成（详见 `prompts-library/README.md`） -- `Skill_Seekers-development/`：以 submodule 引入的 Skills 抓取/制作器（详见 `Skill_Seekers-development/README.md`） -- `html-tools-main/`：HTML 工具集（详见 `html-tools-main/README.md`） -- `my-nvim/`：个人 Neovim 配置（详见 `my-nvim/README.md`） -- `MCPlayerTransfer/`：MC 玩家迁移工具（详见 `MCPlayerTransfer/README.md`） -- `XHS-image-to-PDF-conversion/`：图片合并 PDF（详见 `XHS-image-to-PDF-conversion/README.md`） -- `.tmux/`、`tmux/`、`claude-official-skills/`、`Skill_Seekers-development/`：以 submodule 形式引入的上游仓库 - -> 📝 系统提示词已迁移到云端表格，入口见 [`assets/prompt/README.md`](../prompt/README.md)。 - -## 当前表达状态（2026-04-29） - -目标：`assets/repos/` 是外部工具与依赖的事实来源；需要在其它资产目录展示时，才用相对软链接指向这里。当前只对确有跨目录入口需求的仓库做软链接显示。 - -| 目录 | 当前表示 | 软链接显示 | 备注 | -|:---|:---|:---|:---| -| `.tmux/` | Git submodule | `assets/skills/tmux-autopilot/assets/oh-my-tmux` | oh-my-tmux 配置来源 | -| `tmux/` | Git submodule | `assets/skills/tmux-autopilot/assets/tmux-src` | tmux 上游源码入口 | -| `claude-official-skills/` | Git submodule | `assets/skills/claude-official-skills` | Claude 官方 skills 仓库 | -| `Skill_Seekers-development/` | Git submodule | `assets/skills/auto-skill/scripts/Skill_Seekers-development` | `auto-skill` 的 Skill Seekers 工具来源；`configs` 与 `src` 另有软链接入口 | -| `prompts-library/` | 普通目录 | 无 | 转换工具直接从 `assets/repos/` 使用，不做跨目录软链接显示 | -| `html-tools-main/` | 普通目录 | 无 | 工具目录保持 README 索引 | -| `XHS-image-to-PDF-conversion/` | 普通目录 | 无 | 工具目录保持 README 索引 | -| `chat-vault/` | 普通目录 | 无 | 工具目录保持 README 索引 | -| `MCPlayerTransfer/` | 普通目录 | 无 | 工具目录保持 README 索引 | -| `my-nvim/` | 普通目录 | 无 | Neovim 配置镜像，保持 README 索引 | -| `backups/` | 普通目录 | 无 | 本项目历史备份资产，继续保护 `gz/` 存档 | - -## 表达规则 - -- 外部完整仓库：优先 `git submodule add assets/repos/`。 -- 跨目录展示入口：使用相对软链接，例如 `assets/skills/ -> ../repos/`。 -- 不允许：软链接到本机绝对路径、复制大型上游源码、提交构建产物/生成物、提交二进制运行时。 -- 需要本地改造第三方工具时：优先 fork 后以 submodule 指向 fork；不要在主仓库直接魔改一份不可升级的源码快照。 - -## 新增外部工具（最小清单） - -1. 优先新增 submodule：`git submodule add assets/repos/`。 -2. 只在没有上游仓库、且体量小/与本项目强耦合时，才创建普通目录：`assets/repos//`。 -3. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）。 -4. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分。 -5. 文档同步：在本 README 增加一行工具说明，保证可发现性。 diff --git a/assets/skills/auto-skill/AGENTS.md b/assets/skills/auto-skill/AGENTS.md deleted file mode 100644 index 05322be..0000000 --- a/assets/skills/auto-skill/AGENTS.md +++ /dev/null @@ -1,57 +0,0 @@ -# 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 -> ../../../repos/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`: relative symlink to the `assets/repos/Skill_Seekers-development` submodule. -- `assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the linked Skill Seekers tool. -- `assets/skills/auto-skill/scripts/skill-seekers.sh`: run Skill Seekers from the linked source (docs/github/pdf -> output//). -- `assets/skills/auto-skill/scripts/skill-seekers-import.sh`: import output// into the canonical assets/skills// tree. -- `assets/skills/auto-skill/scripts/skill-seekers-update.sh`: legacy updater; guarded because the tool source now lives in `assets/repos/`. -- `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 linked 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`: legacy helper; do not use it to overwrite the linked `assets/repos/` source. -- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `assets/skills//`. diff --git a/assets/skills/auto-skill/references/skill-seekers.md b/assets/skills/auto-skill/references/skill-seekers.md deleted file mode 100644 index 82ebd49..0000000 --- a/assets/skills/auto-skill/references/skill-seekers.md +++ /dev/null @@ -1,39 +0,0 @@ -# Skill Seekers（链接工具）使用说明 - -本目录通过相对软链接暴露 `assets/repos/Skill_Seekers-development` submodule，用于把「文档 / GitHub 仓库 / PDF」快速转成一个可落地的 Skill 初稿。`assets/repos/` 是源码单一来源，`auto-skill/scripts/` 只保留工具入口。 - -## 目录约定 - -- 工具源码入口：`assets/skills/auto-skill/scripts/Skill_Seekers-development -> ../../../repos/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/repos/Skill_Seekers-development` submodule 指针；`skill-seekers-update.sh` 仅保留为受保护的旧入口。 - -## 推荐工作流（强约束） - -1. 用 Skill Seekers 生成初稿到 `output//` -2. 导入到 `assets/skills//` -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` 为准。 diff --git a/assets/skills/auto-skill/scripts/Skill_Seekers-development b/assets/skills/auto-skill/scripts/Skill_Seekers-development deleted file mode 120000 index 77a246a..0000000 --- a/assets/skills/auto-skill/scripts/Skill_Seekers-development +++ /dev/null @@ -1 +0,0 @@ -../../../repos/Skill_Seekers-development \ No newline at end of file diff --git a/assets/skills/claude-official-skills b/assets/skills/claude-official-skills deleted file mode 120000 index 3e44c09..0000000 --- a/assets/skills/claude-official-skills +++ /dev/null @@ -1 +0,0 @@ -../repos/claude-official-skills \ No newline at end of file diff --git a/assets/skills/tmux-autopilot/assets/oh-my-tmux b/assets/skills/tmux-autopilot/assets/oh-my-tmux deleted file mode 120000 index 9eca8cf..0000000 --- a/assets/skills/tmux-autopilot/assets/oh-my-tmux +++ /dev/null @@ -1 +0,0 @@ -../../../repos/.tmux \ No newline at end of file diff --git a/assets/skills/tmux-autopilot/assets/tmux-src b/assets/skills/tmux-autopilot/assets/tmux-src deleted file mode 120000 index 4cb6c9e..0000000 --- a/assets/skills/tmux-autopilot/assets/tmux-src +++ /dev/null @@ -1 +0,0 @@ -../../../repos/tmux \ No newline at end of file diff --git a/assets/skills/twscrape/references/account_management.md b/assets/skills/twscrape/references/account_management.md deleted file mode 100644 index de2c9ae..0000000 --- a/assets/skills/twscrape/references/account_management.md +++ /dev/null @@ -1,14 +0,0 @@ -# twscrape：账号管理（参考） - -本文件为 `twscrape` 的账号管理参考页。 - -## 推荐阅读顺序 - -1. `assets/skills/twscrape/references/installation.md` -2. `assets/skills/twscrape/SKILL.md`（包含账号池、登录、轮换等完整示例） -3. `assets/skills/twscrape/references/examples.md` - -## 入口 - -- 账号添加/登录的核心示例：`assets/skills/twscrape/SKILL.md` - diff --git a/assets/documents/AGENTS.md b/docs/AGENTS.md similarity index 92% rename from assets/documents/AGENTS.md rename to docs/AGENTS.md index 626df2e..83c5c31 100644 --- a/assets/documents/AGENTS.md +++ b/docs/AGENTS.md @@ -2,12 +2,12 @@ ## 目录用途 -`assets/documents/` 存放项目知识库文档，包含方法论、入门指南、实战案例等。 +`docs/` 存放项目知识库文档，包含方法论、入门指南、实战案例等。 ## 目录结构 ``` -assets/documents/ +docs/ ├── principles/ # 原则与思想（fundamentals + philosophy） │ ├── fundamentals/ # 基础原则、问题求解、工程范式与代码质量 │ └── philosophy/ # 原 05-哲学与方法论 diff --git a/docs/case-studies/README.md b/docs/case-studies/README.md new file mode 100644 index 0000000..a9deabc --- /dev/null +++ b/docs/case-studies/README.md @@ -0,0 +1,18 @@ +# 🎯 实战 + +> 真实项目的开发经验与复盘 + +## 🏗️ 项目实战经验 + +| 项目 | 说明 | +|:---|:---| +| [fate-engine-dev](fate-engine-dev) | Fate Engine 开发记录 | +| [openclaw-dev](openclaw-dev) | OpenClaw 架构 / 部署 / 生态调研资料 | +| [polymarket-dev](polymarket-dev) | Polymarket 数据分析 | +| [telegram-dev](telegram-dev) | Telegram Bot 开发 | + +## 🔗 相关资源 +- [基础指南](../references) - 核心理念与方法论 +- [入门指南](../getting-started) - 环境配置 +- [方法论](../playbooks) - 工具与经验 +- [外部资源（在线表格）](../../README.md) - 外部资源唯一真相源入口 diff --git a/assets/documents/case-studies/fate-engine-dev/ascii可视化-prompt.md b/docs/case-studies/fate-engine-dev/ascii可视化-prompt.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/ascii可视化-prompt.md rename to docs/case-studies/fate-engine-dev/ascii可视化-prompt.md diff --git a/assets/documents/case-studies/fate-engine-dev/prompt-system-bazi-kline.md b/docs/case-studies/fate-engine-dev/prompt-system-bazi-kline.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/prompt-system-bazi-kline.md rename to docs/case-studies/fate-engine-dev/prompt-system-bazi-kline.md diff --git a/assets/documents/case-studies/fate-engine-dev/prompt-user-bazi-kline.md b/docs/case-studies/fate-engine-dev/prompt-user-bazi-kline.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/prompt-user-bazi-kline.md rename to docs/case-studies/fate-engine-dev/prompt-user-bazi-kline.md diff --git a/assets/documents/case-studies/fate-engine-dev/完整性检查-prompt.md b/docs/case-studies/fate-engine-dev/完整性检查-prompt.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/完整性检查-prompt.md rename to docs/case-studies/fate-engine-dev/完整性检查-prompt.md diff --git a/assets/documents/case-studies/fate-engine-dev/胶水开发要求-prompt.md b/docs/case-studies/fate-engine-dev/胶水开发要求-prompt.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/胶水开发要求-prompt.md rename to docs/case-studies/fate-engine-dev/胶水开发要求-prompt.md diff --git a/assets/documents/case-studies/fate-engine-dev/问题描述-prompt.md b/docs/case-studies/fate-engine-dev/问题描述-prompt.md similarity index 100% rename from assets/documents/case-studies/fate-engine-dev/问题描述-prompt.md rename to docs/case-studies/fate-engine-dev/问题描述-prompt.md diff --git a/assets/documents/case-studies/openclaw-dev/OpenClaw 橙皮书 - AI进化论花生.md b/docs/case-studies/openclaw-dev/OpenClaw 橙皮书 - AI进化论花生.md similarity index 100% rename from assets/documents/case-studies/openclaw-dev/OpenClaw 橙皮书 - AI进化论花生.md rename to docs/case-studies/openclaw-dev/OpenClaw 橙皮书 - AI进化论花生.md diff --git a/assets/documents/case-studies/openclaw-dev/README.md b/docs/case-studies/openclaw-dev/README.md similarity index 100% rename from assets/documents/case-studies/openclaw-dev/README.md rename to docs/case-studies/openclaw-dev/README.md diff --git a/assets/documents/case-studies/polymarket-dev/POLYMARKET_LINK_FORMAT.md b/docs/case-studies/polymarket-dev/POLYMARKET_LINK_FORMAT.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/POLYMARKET_LINK_FORMAT.md rename to docs/case-studies/polymarket-dev/POLYMARKET_LINK_FORMAT.md diff --git a/assets/documents/case-studies/polymarket-dev/Polymarket 套利全解析.md b/docs/case-studies/polymarket-dev/Polymarket 套利全解析.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/Polymarket 套利全解析.md rename to docs/case-studies/polymarket-dev/Polymarket 套利全解析.md diff --git a/assets/documents/case-studies/polymarket-dev/README.md b/docs/case-studies/polymarket-dev/README.md similarity index 54% rename from assets/documents/case-studies/polymarket-dev/README.md rename to docs/case-studies/polymarket-dev/README.md index a165baf..4ef09b0 100644 --- a/assets/documents/case-studies/polymarket-dev/README.md +++ b/docs/case-studies/polymarket-dev/README.md @@ -10,13 +10,13 @@ Polymarket 预测市场数据的采集、分析和可视化，包含 K 线图 AS | 文件 | 说明 | |:---|:---| -| [ascii可视化-prompt.md](./ascii可视化-prompt.md) | ASCII 字符绘制 K 线图的提示词 | +| [ascii可视化-prompt.md](ascii可视化-prompt.md) | ASCII 字符绘制 K 线图的提示词 | | [prompt-system-bazi-kline.md](../fate-engine-dev/prompt-system-bazi-kline.md) | 系统提示词：K 线分析 | | [prompt-user-bazi-kline.md](../fate-engine-dev/prompt-user-bazi-kline.md) | 用户提示词：K 线分析 | -| [胶水开发要求-prompt.md](./胶水开发要求-prompt.md) | 胶水代码开发规范提示词 | -| [完整性检查-prompt.md](./完整性检查-prompt.md) | 代码完整性检查提示词 | -| [复查-prompt.md](./复查-prompt.md) | 代码复查提示词 | -| [问题描述-prompt.md](./问题描述-prompt.md) | 问题描述模板提示词 | +| [胶水开发要求-prompt.md](胶水开发要求-prompt.md) | 胶水代码开发规范提示词 | +| [完整性检查-prompt.md](完整性检查-prompt.md) | 代码完整性检查提示词 | +| [复查-prompt.md](复查-prompt.md) | 代码复查提示词 | +| [问题描述-prompt.md](问题描述-prompt.md) | 问题描述模板提示词 | ## 技术栈 diff --git a/assets/documents/case-studies/polymarket-dev/ascii可视化-prompt.md b/docs/case-studies/polymarket-dev/ascii可视化-prompt.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/ascii可视化-prompt.md rename to docs/case-studies/polymarket-dev/ascii可视化-prompt.md diff --git a/assets/documents/case-studies/polymarket-dev/复查-prompt.md b/docs/case-studies/polymarket-dev/复查-prompt.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/复查-prompt.md rename to docs/case-studies/polymarket-dev/复查-prompt.md diff --git a/assets/documents/case-studies/polymarket-dev/完整性检查-prompt.md b/docs/case-studies/polymarket-dev/完整性检查-prompt.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/完整性检查-prompt.md rename to docs/case-studies/polymarket-dev/完整性检查-prompt.md diff --git a/assets/documents/case-studies/polymarket-dev/胶水开发要求-prompt.md b/docs/case-studies/polymarket-dev/胶水开发要求-prompt.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/胶水开发要求-prompt.md rename to docs/case-studies/polymarket-dev/胶水开发要求-prompt.md diff --git a/assets/documents/case-studies/polymarket-dev/问题描述-prompt.md b/docs/case-studies/polymarket-dev/问题描述-prompt.md similarity index 100% rename from assets/documents/case-studies/polymarket-dev/问题描述-prompt.md rename to docs/case-studies/polymarket-dev/问题描述-prompt.md diff --git a/assets/documents/case-studies/telegram-dev/README.md b/docs/case-studies/telegram-dev/README.md similarity index 74% rename from assets/documents/case-studies/telegram-dev/README.md rename to docs/case-studies/telegram-dev/README.md index aaaf11d..fdbedf6 100644 --- a/assets/documents/case-studies/telegram-dev/README.md +++ b/docs/case-studies/telegram-dev/README.md @@ -10,7 +10,7 @@ Telegram Bot 开发中遇到的问题和解决方案，主要涉及消息格式 | 文件 | 说明 | |:---|:---| -| [telegram Markdown 代码块格式修复记录 2025-12-15.md](./telegram%20Markdown%20代码块格式修复记录%202025-12-15.md) | Telegram Markdown 代码块渲染问题修复 | +| [telegram Markdown 代码块格式修复记录 2025-12-15.md](telegram%20Markdown%20代码块格式修复记录%202025-12-15.md) | Telegram Markdown 代码块渲染问题修复 | ## 技术栈 diff --git a/assets/documents/case-studies/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md b/docs/case-studies/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md similarity index 100% rename from assets/documents/case-studies/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md rename to docs/case-studies/telegram-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md diff --git a/assets/documents/principles/fundamentals/A Formalization of Recursive Self-Optimizing Generative Systems.md b/docs/concepts/A Formalization of Recursive Self-Optimizing Generative Systems.md similarity index 100% rename from assets/documents/principles/fundamentals/A Formalization of Recursive Self-Optimizing Generative Systems.md rename to docs/concepts/A Formalization of Recursive Self-Optimizing Generative Systems.md diff --git a/assets/documents/principles/fundamentals/Harness Engineering 的本质拆解.md b/docs/concepts/Harness Engineering 的本质拆解.md similarity index 100% rename from assets/documents/principles/fundamentals/Harness Engineering 的本质拆解.md rename to docs/concepts/Harness Engineering 的本质拆解.md diff --git a/assets/documents/principles/philosophy/AI蜂群协作.md b/docs/concepts/philosophy/AI蜂群协作.md similarity index 78% rename from assets/documents/principles/philosophy/AI蜂群协作.md rename to docs/concepts/philosophy/AI蜂群协作.md index 02ecdc4..9844131 100644 --- a/assets/documents/principles/philosophy/AI蜂群协作.md +++ b/docs/concepts/philosophy/AI蜂群协作.md @@ -22,8 +22,8 @@ AI 不再是孤立的，而是可以互相感知、通讯、控制的集群。 ## 详细文档 -👉 [深入了解AI蜂群协作](../../guides/playbook/AI蜂群协作-tmux多Agent协作系统.md) +👉 [深入了解AI蜂群协作](../../playbooks/AI蜂群协作-tmux多Agent协作系统.md) ## 相关资源 -- [tmux快捷键大全](../../guides/playbook/tmux快捷键大全.md) +- [tmux快捷键大全](../../playbooks/tmux快捷键大全.md) diff --git a/assets/documents/principles/philosophy/README.md b/docs/concepts/philosophy/README.md similarity index 99% rename from assets/documents/principles/philosophy/README.md rename to docs/concepts/philosophy/README.md index e84e8a9..003356c 100644 --- a/assets/documents/principles/philosophy/README.md +++ b/docs/concepts/philosophy/README.md @@ -201,7 +201,7 @@ ruff + black + pyright(或 mypy) + pytest + hypothesis + pydantic(msgspec可替 **扩展阅读**： -- [`控制论与科学方法论`](./控制论与科学方法论.md) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制 +- [`控制论与科学方法论`](控制论与科学方法论.md) - 用“可能性空间/反馈/信息/黑箱/可证伪”解释从试错到收敛的机制 --- diff --git a/assets/documents/principles/philosophy/控制论与科学方法论.md b/docs/concepts/philosophy/控制论与科学方法论.md similarity index 100% rename from assets/documents/principles/philosophy/控制论与科学方法论.md rename to docs/concepts/philosophy/控制论与科学方法论.md diff --git a/assets/documents/principles/philosophy/现象学还原.md b/docs/concepts/philosophy/现象学还原.md similarity index 100% rename from assets/documents/principles/philosophy/现象学还原.md rename to docs/concepts/philosophy/现象学还原.md diff --git a/assets/documents/principles/philosophy/理解世界、描述变化、整理知识的一套较小框架.md b/docs/concepts/philosophy/理解世界、描述变化、整理知识的一套较小框架.md similarity index 100% rename from assets/documents/principles/philosophy/理解世界、描述变化、整理知识的一套较小框架.md rename to docs/concepts/philosophy/理解世界、描述变化、整理知识的一套较小框架.md diff --git a/assets/documents/principles/philosophy/辩证法.md b/docs/concepts/philosophy/辩证法.md similarity index 100% rename from assets/documents/principles/philosophy/辩证法.md rename to docs/concepts/philosophy/辩证法.md diff --git a/assets/documents/principles/fundamentals/拼好码.md b/docs/concepts/拼好码.md similarity index 99% rename from assets/documents/principles/fundamentals/拼好码.md rename to docs/concepts/拼好码.md index 90d5a8a..ed31af7 100644 --- a/assets/documents/principles/fundamentals/拼好码.md +++ b/docs/concepts/拼好码.md @@ -467,6 +467,6 @@ AI 特别适合生成： ## 延伸阅读 -- [语言层要素](./语言层要素.md) - 看懂代码需要掌握的语言层级 -- [胶水开发提示词（在线提示词库入口）](../../../prompt/README.md) -- [项目实战：polymarket-dev](../../case-studies/polymarket-dev/) +- [语言层要素](语言层要素.md) - 看懂代码需要掌握的语言层级 +- [胶水开发提示词（在线提示词库入口）](../../../prompts/README.md) +- [项目实战：polymarket-dev](../case-studies/polymarket-dev/) diff --git a/assets/documents/principles/fundamentals/编程之道.md b/docs/concepts/编程之道.md similarity index 100% rename from assets/documents/principles/fundamentals/编程之道.md rename to docs/concepts/编程之道.md diff --git a/assets/documents/principles/fundamentals/语言层要素.md b/docs/concepts/语言层要素.md similarity index 100% rename from assets/documents/principles/fundamentals/语言层要素.md rename to docs/concepts/语言层要素.md diff --git a/assets/documents/principles/fundamentals/软件开发范式演进.md b/docs/concepts/软件开发范式演进.md similarity index 100% rename from assets/documents/principles/fundamentals/软件开发范式演进.md rename to docs/concepts/软件开发范式演进.md diff --git a/assets/documents/principles/fundamentals/问题分析与系统构建方法.md b/docs/concepts/问题分析与系统构建方法.md similarity index 100% rename from assets/documents/principles/fundamentals/问题分析与系统构建方法.md rename to docs/concepts/问题分析与系统构建方法.md diff --git a/assets/documents/principles/fundamentals/问题求解能力.md b/docs/concepts/问题求解能力.md similarity index 100% rename from assets/documents/principles/fundamentals/问题求解能力.md rename to docs/concepts/问题求解能力.md diff --git a/assets/documents/guides/getting-started/Codex-CLI配置.md b/docs/getting-started/Codex-CLI配置.md similarity index 95% rename from assets/documents/guides/getting-started/Codex-CLI配置.md rename to docs/getting-started/Codex-CLI配置.md index b5a7834..ef3196a 100644 --- a/assets/documents/guides/getting-started/Codex-CLI配置.md +++ b/docs/getting-started/Codex-CLI配置.md @@ -6,7 +6,7 @@ Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、代码修改、命令执行、测试验证到 Git 提交的主流程。 -OpenCode CLI 保留为备选方案：当你暂时无法使用 OpenAI / Codex CLI，或只想接入免费模型时，再使用 [OpenCode-CLI配置](./OpenCode-CLI配置.md)。 +OpenCode CLI 保留为备选方案：当你暂时无法使用 OpenAI / Codex CLI，或只想接入免费模型时，再使用 [OpenCode-CLI配置](OpenCode-CLI配置.md)。 ## 不会操作？先让网页 AI 生成逐步执行版 @@ -237,15 +237,15 @@ $env:OPENAI_API_KEY | codex login --with-api-key 本仓库已经提供 Codex CLI 配置基线： -- `assets/config/.codex/config.toml` -- `assets/config/.codex/AGENTS.md` +- `tools/config/.codex/config.toml` +- `tools/config/.codex/AGENTS.md` 在仓库根目录执行： ```bash mkdir -p ~/.codex -cp -f assets/config/.codex/config.toml ~/.codex/config.toml -cp -f assets/config/.codex/AGENTS.md ~/.codex/AGENTS.md +cp -f tools/config/.codex/config.toml ~/.codex/config.toml +cp -f tools/config/.codex/AGENTS.md ~/.codex/AGENTS.md ``` 详细说明见：[Codex 配置基线](../../../config/.codex/README.md)。 @@ -338,6 +338,6 @@ codex login ## 下一步 -→ [开发环境搭建](./开发环境搭建.md) - 回看基础环境 +→ [开发环境搭建](开发环境搭建.md) - 回看基础环境 -→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案 +→ [OpenCode-CLI配置](OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案 diff --git a/assets/documents/guides/getting-started/IDE配置.md b/docs/getting-started/IDE配置.md similarity index 98% rename from assets/documents/guides/getting-started/IDE配置.md rename to docs/getting-started/IDE配置.md index d7af498..cc9ccf2 100644 --- a/assets/documents/guides/getting-started/IDE配置.md +++ b/docs/getting-started/IDE配置.md @@ -2,7 +2,7 @@ > 使用方法：复制下方对应你 IDE 的提示词，粘贴到任意 AI 对话框，AI 会一步步指导你完成配置。 -**前置条件**：请先完成 [开发环境搭建](./开发环境搭建.md) +**前置条件**：请先完成 [开发环境搭建](开发环境搭建.md) --- diff --git a/assets/documents/guides/getting-started/OpenCode-CLI配置.md b/docs/getting-started/OpenCode-CLI配置.md similarity index 94% rename from assets/documents/guides/getting-started/OpenCode-CLI配置.md rename to docs/getting-started/OpenCode-CLI配置.md index 62b1a2a..d6f8863 100644 --- a/assets/documents/guides/getting-started/OpenCode-CLI配置.md +++ b/docs/getting-started/OpenCode-CLI配置.md @@ -2,7 +2,7 @@ > 备选 AI CLI 路线：当你暂时无法使用 Codex CLI，或希望接入免费/本地模型时使用。 -本教程默认推荐 [Codex CLI](./Codex-CLI配置.md)。OpenCode 是开源 AI 编程代理，支持终端、桌面应用和 IDE 扩展，适合用作免费模型、本地模型或多模型实验入口。 +本教程默认推荐 [Codex CLI](Codex-CLI配置.md)。OpenCode 是开源 AI 编程代理，支持终端、桌面应用和 IDE 扩展，适合用作免费模型、本地模型或多模型实验入口。 官网：[opencode.ai](https://opencode.ai/) @@ -38,7 +38,7 @@ - 需要接入 Z.AI、MiniMax、Hugging Face、本地 Ollama 等模型 - 想保留一条不依赖单一模型提供商的备份路线 -如果 Codex CLI 可用，优先完成：[Codex-CLI配置](./Codex-CLI配置.md)。 +如果 Codex CLI 可用，优先完成：[Codex-CLI配置](Codex-CLI配置.md)。 ## 安装 diff --git a/assets/documents/guides/getting-started/README.md b/docs/getting-started/README.md similarity index 63% rename from assets/documents/guides/getting-started/README.md rename to docs/getting-started/README.md index d9fb503..6881da3 100644 --- a/assets/documents/guides/getting-started/README.md +++ b/docs/getting-started/README.md @@ -27,14 +27,14 @@ ## 📚 学习路径 -0. [学习地图](./学习地图.md) - 先按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线 -1. [问题求解能力](../../principles/fundamentals/问题求解能力.md) - 先学会定义问题与验收标准 -2. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 -3. [网络环境配置](./网络环境配置.md) - 配置网络访问 -4. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线 -5. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境 +0. [学习地图](学习地图.md) - 先按目标选择新手、开发者、团队、Prompt、Skill、Workflow 或 GEO/SEO 路线 +1. [问题求解能力](../concepts/问题求解能力.md) - 先学会定义问题与验收标准 +2. [Vibe Coding 经验](Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 +3. [网络环境配置](网络环境配置.md) - 配置网络访问 +4. [Codex CLI 配置](Codex-CLI配置.md) - 默认 AI CLI 路线 +5. [开发环境搭建](开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境 ## 🔗 相关资源 -- [基础指南](../../principles/fundamentals/) - 核心理念与方法论 -- [方法论](../playbook/) - 工具与经验 -- [实战](../../case-studies/) - 动手实践项目 +- [基础指南](../references) - 核心理念与方法论 +- [方法论](../playbooks) - 工具与经验 +- [实战](../case-studies) - 动手实践项目 diff --git a/assets/documents/guides/getting-started/Vibe Coding 经验.md b/docs/getting-started/Vibe Coding 经验.md similarity index 96% rename from assets/documents/guides/getting-started/Vibe Coding 经验.md rename to docs/getting-started/Vibe Coding 经验.md index c90d6b0..f2d3b1a 100644 --- a/assets/documents/guides/getting-started/Vibe Coding 经验.md +++ b/docs/getting-started/Vibe Coding 经验.md @@ -99,6 +99,6 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认 ## 下一步 -→ [Codex-CLI配置](./Codex-CLI配置.md) - 默认 AI CLI 路线 +→ [Codex-CLI配置](Codex-CLI配置.md) - 默认 AI CLI 路线 -→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选路线 +→ [OpenCode-CLI配置](OpenCode-CLI配置.md) - Codex CLI 不可用时的备选路线 diff --git a/assets/documents/guides/getting-started/学习地图.md b/docs/getting-started/学习地图.md similarity index 71% rename from assets/documents/guides/getting-started/学习地图.md rename to docs/getting-started/学习地图.md index 847dd20..51658e4 100644 --- a/assets/documents/guides/getting-started/学习地图.md +++ b/docs/getting-started/学习地图.md @@ -13,27 +13,27 @@ | 路线 | 适合谁 | 目标 | 首选入口 | |:---|:---|:---|:---| -| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../../principles/fundamentals/问题求解能力.md) | -| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](./Vibe%20Coding%20经验.md) | -| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompt/README.md) | +| 零基础路线 | 不会编程或刚开始 | 跑通从想法到项目的最小闭环 | [问题求解能力](../concepts/问题求解能力.md) | +| 开发者路线 | 已会写代码 | 建立 AI 结对编程工作流 | [Vibe Coding 经验](Vibe%20Coding%20经验.md) | +| Prompt 路线 | 想提升提问质量 | 把需求表达成可执行指令 | [提示词库](../../../prompts/README.md) | | Skill 路线 | 想沉淀复用能力 | 把高频任务做成可重复调用的技能 | [Skills 技能大全](../../../skills/README.md) | -| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../../workflow/README.md) | -| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../../principles/fundamentals/强前置条件约束.md) | -| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md) | +| Workflow 路线 | 想推进复杂项目 | 把开发过程拆成可跟踪、可复盘的流程 | [工作流模板](../playbooks/workflows/README.md) | +| 质量门禁路线 | 担心 AI 乱写代码 | 用测试、CI、schema、清单约束 AI 输出 | [强前置条件约束](../references/强前置条件约束.md) | +| GEO/SEO 路线 | 想提升仓库被引用概率 | 建设 AI 可理解、可引用、可验证的内容资产 | [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) | ## 路线一：零基础路线 目标：完成一次“想法 -> 需求 -> 方案 -> 任务 -> AI 编码 -> 验证 -> Git 保存”的最小闭环。 -1. [问题求解能力](../../principles/fundamentals/问题求解能力.md) +1. [问题求解能力](../concepts/问题求解能力.md) 先学会把问题说清楚：目标、现状、差距、标准、约束、对象、路径。 -2. [网络环境配置](./网络环境配置.md) +2. [网络环境配置](网络环境配置.md) 解决访问 AI 工具、GitHub、文档和依赖源的问题。 -3. [Codex CLI 配置](./Codex-CLI配置.md) +3. [Codex CLI 配置](Codex-CLI配置.md) 配置默认 AI CLI 路线，让 AI 能在终端里协助执行工程动作。 -4. [开发环境搭建](./开发环境搭建.md) +4. [开发环境搭建](开发环境搭建.md) 配好 Git、Node.js、Python、编辑器等基础环境。 -5. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) +5. [Vibe Coding 经验](Vibe%20Coding%20经验.md) 学会人机分工、门禁、复盘和用 AI 审 AI。 完成标准： @@ -48,15 +48,15 @@ 目标：把 AI 从“临时助手”变成稳定的工程协作者。 -1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) +1. [Vibe Coding 经验](Vibe%20Coding%20经验.md) 先建立人机分工和质量意识。 -2. [拼好码](../../principles/fundamentals/拼好码.md) +2. [拼好码](../concepts/拼好码.md) 优先复用成熟能力，把自研代码限制在连接、编排、适配和业务逻辑。 -3. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md) +3. [强前置条件约束](../references/强前置条件约束.md) 在任务开始前写清楚目标、边界、禁止项、验收标准和门禁。 -4. [常见坑汇总](../../principles/fundamentals/常见坑汇总.md) +4. [常见坑汇总](../references/常见坑汇总.md) 识别 AI 编程中的上下文漂移、过度实现、幻觉和不可验证输出。 -5. [底层程序逻辑设计与工程优化项](../../principles/fundamentals/底层程序逻辑设计与工程优化项.md) +5. [底层程序逻辑设计与工程优化项](../references/底层程序逻辑设计与工程优化项.md) 用更稳定的代码结构和检查项约束实现质量。 完成标准： @@ -70,10 +70,10 @@ 目标：把自然语言需求写成可执行、可检查、可复用的指令。 -1. [提示词库入口](../../../prompt/README.md) -2. [系统提示词构建原则](../../principles/fundamentals/系统提示词构建原则.md) -3. [语言层要素](../../principles/fundamentals/语言层要素.md) -4. [问题求解能力](../../principles/fundamentals/问题求解能力.md) +1. [提示词库入口](../../../prompts/README.md) +2. [系统提示词构建原则](../references/系统提示词构建原则.md) +3. [语言层要素](../concepts/语言层要素.md) +4. [问题求解能力](../concepts/问题求解能力.md) 练习方式： @@ -101,10 +101,10 @@ 目标：把复杂项目推进变成可跟踪、可复盘、可交接的流程。 -1. [工作流模板](../../workflow/README.md) -2. [自动开发闭环](../../workflow/auto-dev-loop/README.md) -3. [通用项目架构模板](../../principles/fundamentals/通用项目架构模板.md) -4. [审查代码](../../principles/fundamentals/审查代码.md) +1. [工作流模板](../playbooks/workflows/README.md) +2. [自动开发闭环](../playbooks/workflows/auto-dev-loop/README.md) +3. [通用项目架构模板](../references/通用项目架构模板.md) +4. [审查代码](../references/审查代码.md) 推荐流程： @@ -126,9 +126,9 @@ 优先阅读： 1. [AGENTS.md](../../../../AGENTS.md) -2. [强前置条件约束](../../principles/fundamentals/强前置条件约束.md) -3. [AI 蜂群协作](../playbook/AI蜂群协作-tmux多Agent协作系统.md) -4. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md) +2. [强前置条件约束](../references/强前置条件约束.md) +3. [AI 蜂群协作](../playbooks/AI蜂群协作-tmux多Agent协作系统.md) +4. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) 团队约束： @@ -141,7 +141,7 @@ 目标：让项目更容易被搜索引擎、AI 搜索和大语言模型理解、引用、推荐。 -1. [GEO 与 SEO 优化方法](../playbook/GEO与SEO优化方法.md) +1. [GEO 与 SEO 优化方法](../playbooks/GEO与SEO优化方法.md) 2. [ai-citation-pack](../../../../ai-citation-pack/recommended-answer.md) 3. [llms.txt](../../../../llms.txt) 4. [llms-full.txt](../../../../llms-full.txt) @@ -172,6 +172,6 @@ ## 下一步 -- 新手：回到 [入门指南](./README.md)，从第 0 步开始。 -- 开发者：阅读 [Vibe Coding 经验](./Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。 +- 新手：回到 [入门指南](README.md)，从第 0 步开始。 +- 开发者：阅读 [Vibe Coding 经验](Vibe%20Coding%20经验.md)，再选择 Skill 或 Workflow 路线。 - 团队：先统一 [AGENTS.md](../../../../AGENTS.md)、强前置条件和质量门禁。 diff --git a/assets/documents/guides/getting-started/开发环境搭建.md b/docs/getting-started/开发环境搭建.md similarity index 97% rename from assets/documents/guides/getting-started/开发环境搭建.md rename to docs/getting-started/开发环境搭建.md index 331ae6d..36fdb66 100644 --- a/assets/documents/guides/getting-started/开发环境搭建.md +++ b/docs/getting-started/开发环境搭建.md @@ -2,7 +2,7 @@ > 使用方法：复制下方对应你设备的提示词，粘贴到任意 AI 对话框（ChatGPT、Claude、Gemini 网页版等），AI 会一步步指导你完成配置。 -**前置条件**：请先完成 [网络环境配置](./网络环境配置.md) +**前置条件**：请先完成 [网络环境配置](网络环境配置.md) --- @@ -185,4 +185,4 @@ alias oc='opencode' 环境搭建完成后，继续下一步： -→ [Codex-CLI配置](./Codex-CLI配置.md) - 配置默认 AI CLI +→ [Codex-CLI配置](Codex-CLI配置.md) - 配置默认 AI CLI diff --git a/assets/documents/guides/getting-started/网络环境配置.md b/docs/getting-started/网络环境配置.md similarity index 97% rename from assets/documents/guides/getting-started/网络环境配置.md rename to docs/getting-started/网络环境配置.md index 9d72fb2..8c6f6d4 100644 --- a/assets/documents/guides/getting-started/网络环境配置.md +++ b/docs/getting-started/网络环境配置.md @@ -133,4 +133,4 @@ export http_proxy=http://127.0.0.1:7890 ## 下一步 -网络配置完成后，继续阅读 [开发环境搭建](./开发环境搭建.md)。 +网络配置完成后，继续阅读 [开发环境搭建](开发环境搭建.md)。 diff --git a/docs/guides/README.md b/docs/guides/README.md new file mode 100644 index 0000000..266488d --- /dev/null +++ b/docs/guides/README.md @@ -0,0 +1,9 @@ +# 操作指南 + +本目录预留给面向具体工具、平台或操作场景的指南。 + +当前主要操作流程已归入： + +- [从零开始](../getting-started/) +- [可复用流程](../playbooks/) +- [参考清单](../references/) diff --git a/assets/documents/guides/playbook/AI蜂群协作-tmux多Agent协作系统.md b/docs/playbooks/AI蜂群协作-tmux多Agent协作系统.md similarity index 100% rename from assets/documents/guides/playbook/AI蜂群协作-tmux多Agent协作系统.md rename to docs/playbooks/AI蜂群协作-tmux多Agent协作系统.md diff --git a/assets/documents/guides/playbook/GEMINI-HEADLESS.md b/docs/playbooks/GEMINI-HEADLESS.md similarity index 100% rename from assets/documents/guides/playbook/GEMINI-HEADLESS.md rename to docs/playbooks/GEMINI-HEADLESS.md diff --git a/assets/documents/guides/playbook/GEO与SEO优化方法.md b/docs/playbooks/GEO与SEO优化方法.md similarity index 100% rename from assets/documents/guides/playbook/GEO与SEO优化方法.md rename to docs/playbooks/GEO与SEO优化方法.md diff --git a/assets/documents/guides/playbook/LazyVim快捷键大全.md b/docs/playbooks/LazyVim快捷键大全.md similarity index 100% rename from assets/documents/guides/playbook/LazyVim快捷键大全.md rename to docs/playbooks/LazyVim快捷键大全.md diff --git a/assets/documents/guides/playbook/ProxyCast配置文档.md b/docs/playbooks/ProxyCast配置文档.md similarity index 100% rename from assets/documents/guides/playbook/ProxyCast配置文档.md rename to docs/playbooks/ProxyCast配置文档.md diff --git a/docs/playbooks/README.md b/docs/playbooks/README.md new file mode 100644 index 0000000..30565fe --- /dev/null +++ b/docs/playbooks/README.md @@ -0,0 +1,29 @@ +# 🛠️ 方法论 + +> 工具使用、开发经验与实践技巧 + +## 🎨 AI 协作范式 + +- [AI蜂群协作](AI蜂群协作-tmux多Agent协作系统.md) - 基于 tmux 的多 AI Agent 协作系统 + +## 📖 工具教程 + +- [tmux 快捷键大全](tmux快捷键大全.md) - 终端复用工具 +- [LazyVim 快捷键大全](LazyVim快捷键大全.md) - Neovim 配置框架 +- [Augment MCP 配置](auggie-mcp配置文档.md) - 上下文引擎配置 +- [ProxyCast 配置](ProxyCast配置文档.md) - AI 凭证代理服务配置 +- [TradeCat Sheets API 使用说明](tradecat-sheets-api-usage.md) - 把公开 Google Sheet 当作 API 注册表与数据面（Data Plane） +- [手机远程 Vibe Coding](关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发 +- [VS Code Remote Tunnel（WSL）](REMOTE_TUNNEL_GUIDE.md) - 在 WSL 内开通 VS Code Tunnel 供远程访问 +- [GEMINI-HEADLESS](GEMINI-HEADLESS.md) - Gemini 无头模式配置 + +## 🛠️ 开发经验 + +- [开发经验](../references/开发经验.md) - 变量命名、文件结构、编码规范 +- [Vibe Coding 经验收集](vibe-coding-经验收集.md) - 社区经验汇总 +- [GEO 与 SEO 优化方法](GEO与SEO优化方法.md) - 从 GEOFlow 学到的内容工程方法，让仓库更容易被搜索引擎和 AI 引用 + +## 🔗 相关资源 +- [基础指南](../references) - 核心理念与方法论 +- [入门指南](../getting-started) - 从零开始 +- [实战](../case-studies) - 动手实践 diff --git a/assets/documents/guides/playbook/REMOTE_TUNNEL_GUIDE.md b/docs/playbooks/REMOTE_TUNNEL_GUIDE.md similarity index 100% rename from assets/documents/guides/playbook/REMOTE_TUNNEL_GUIDE.md rename to docs/playbooks/REMOTE_TUNNEL_GUIDE.md diff --git a/assets/documents/guides/playbook/auggie-mcp配置文档.md b/docs/playbooks/auggie-mcp配置文档.md similarity index 100% rename from assets/documents/guides/playbook/auggie-mcp配置文档.md rename to docs/playbooks/auggie-mcp配置文档.md diff --git a/assets/documents/guides/playbook/tmux快捷键大全.md b/docs/playbooks/tmux快捷键大全.md similarity index 100% rename from assets/documents/guides/playbook/tmux快捷键大全.md rename to docs/playbooks/tmux快捷键大全.md diff --git a/assets/documents/guides/playbook/tradecat-sheets-api-usage.md b/docs/playbooks/tradecat-sheets-api-usage.md similarity index 100% rename from assets/documents/guides/playbook/tradecat-sheets-api-usage.md rename to docs/playbooks/tradecat-sheets-api-usage.md diff --git a/assets/documents/guides/playbook/vibe-coding-经验收集.md b/docs/playbooks/vibe-coding-经验收集.md similarity index 100% rename from assets/documents/guides/playbook/vibe-coding-经验收集.md rename to docs/playbooks/vibe-coding-经验收集.md diff --git a/assets/documents/workflow/20260225-Markdown转EPUB-v1.0.md b/docs/playbooks/workflows/20260225-Markdown转EPUB-v1.0.md similarity index 100% rename from assets/documents/workflow/20260225-Markdown转EPUB-v1.0.md rename to docs/playbooks/workflows/20260225-Markdown转EPUB-v1.0.md diff --git a/assets/documents/workflow/AGENTS.md b/docs/playbooks/workflows/AGENTS.md similarity index 87% rename from assets/documents/workflow/AGENTS.md rename to docs/playbooks/workflows/AGENTS.md index 07d95c6..b8d41de 100644 --- a/assets/documents/workflow/AGENTS.md +++ b/docs/playbooks/workflows/AGENTS.md @@ -1,11 +1,11 @@ # Workflow 目录 Agent 指南 -`assets/documents/workflow/` 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。 +`docs/playbooks/workflows/` 存放可复用的工作流模板：把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。 ## 目录结构（当前） ```text -assets/documents/workflow/ +docs/playbooks/workflows/ ├── AGENTS.md # 本文件（目录级行为准则） ├── README.md # workflow 总览 ├── auto-dev-loop/ # 全自动开发闭环（五步状态机） diff --git a/assets/documents/workflow/README.md b/docs/playbooks/workflows/README.md similarity index 76% rename from assets/documents/workflow/README.md rename to docs/playbooks/workflows/README.md index 02324f7..e6917b6 100644 --- a/assets/documents/workflow/README.md +++ b/docs/playbooks/workflows/README.md @@ -5,7 +5,7 @@ ## 目录结构 ``` -assets/documents/workflow/ +docs/playbooks/workflows/ ├── auto-dev-loop/ # 全自动开发闭环工作流（五步Agent） ├── <其他工作流>/ └── README.md @@ -15,7 +15,7 @@ assets/documents/workflow/ | 工作流 | 说明 | |--------|------| -| [auto-dev-loop](./auto-dev-loop/) | 基于状态机+Hook的五步AI Agent闭环开发流程 | +| [auto-dev-loop](auto-dev-loop) | 基于状态机+Hook的五步AI Agent闭环开发流程 | ## 添加新工作流 diff --git a/assets/documents/workflow/auto-dev-loop/.kiro/agents/workflow.json b/docs/playbooks/workflows/auto-dev-loop/.kiro/agents/workflow.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/.kiro/agents/workflow.json rename to docs/playbooks/workflows/auto-dev-loop/.kiro/agents/workflow.json diff --git a/assets/documents/workflow/auto-dev-loop/CHANGELOG.md b/docs/playbooks/workflows/auto-dev-loop/CHANGELOG.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/CHANGELOG.md rename to docs/playbooks/workflows/auto-dev-loop/CHANGELOG.md diff --git a/assets/documents/workflow/auto-dev-loop/README.md b/docs/playbooks/workflows/auto-dev-loop/README.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/README.md rename to docs/playbooks/workflows/auto-dev-loop/README.md diff --git a/assets/documents/workflow/auto-dev-loop/step1_需求输入.jsonl b/docs/playbooks/workflows/auto-dev-loop/step1_需求输入.jsonl similarity index 100% rename from assets/documents/workflow/auto-dev-loop/step1_需求输入.jsonl rename to docs/playbooks/workflows/auto-dev-loop/step1_需求输入.jsonl diff --git a/assets/documents/workflow/auto-dev-loop/step2_执行计划.jsonl b/docs/playbooks/workflows/auto-dev-loop/step2_执行计划.jsonl similarity index 100% rename from assets/documents/workflow/auto-dev-loop/step2_执行计划.jsonl rename to docs/playbooks/workflows/auto-dev-loop/step2_执行计划.jsonl diff --git a/assets/documents/workflow/auto-dev-loop/step3_实施变更.jsonl b/docs/playbooks/workflows/auto-dev-loop/step3_实施变更.jsonl similarity index 100% rename from assets/documents/workflow/auto-dev-loop/step3_实施变更.jsonl rename to docs/playbooks/workflows/auto-dev-loop/step3_实施变更.jsonl diff --git a/assets/documents/workflow/auto-dev-loop/step4_验证发布.jsonl b/docs/playbooks/workflows/auto-dev-loop/step4_验证发布.jsonl similarity index 100% rename from assets/documents/workflow/auto-dev-loop/step4_验证发布.jsonl rename to docs/playbooks/workflows/auto-dev-loop/step4_验证发布.jsonl diff --git a/assets/documents/workflow/auto-dev-loop/step5_总控与循环.jsonl b/docs/playbooks/workflows/auto-dev-loop/step5_总控与循环.jsonl similarity index 100% rename from assets/documents/workflow/auto-dev-loop/step5_总控与循环.jsonl rename to docs/playbooks/workflows/auto-dev-loop/step5_总控与循环.jsonl diff --git a/assets/documents/workflow/auto-dev-loop/workflow-orchestrator/AGENTS.md b/docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/AGENTS.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow-orchestrator/AGENTS.md rename to docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/AGENTS.md diff --git a/assets/documents/workflow/auto-dev-loop/workflow-orchestrator/CHANGELOG.md b/docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/CHANGELOG.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow-orchestrator/CHANGELOG.md rename to docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/CHANGELOG.md diff --git a/assets/documents/workflow/auto-dev-loop/workflow-orchestrator/SKILL.md b/docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/SKILL.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow-orchestrator/SKILL.md rename to docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/SKILL.md diff --git a/assets/documents/workflow/auto-dev-loop/workflow-orchestrator/references/index.md b/docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/references/index.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow-orchestrator/references/index.md rename to docs/playbooks/workflows/auto-dev-loop/workflow-orchestrator/references/index.md diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/README.md b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/README.md similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/README.md rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/README.md diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step1.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step1.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step1.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step1.json diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step2.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step2.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step2.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step2.json diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step3.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step3.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step3.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step3.json diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step4.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step4.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step4.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step4.json diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step5.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step5.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step5.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/artifacts/20251225T054501/step5.json diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/hook_runner.sh b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/hook_runner.sh similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/hook_runner.sh rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/hook_runner.sh diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/runner.py b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/runner.py similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/runner.py rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/runner.py diff --git a/assets/documents/workflow/auto-dev-loop/workflow_engine/state/current_step.json b/docs/playbooks/workflows/auto-dev-loop/workflow_engine/state/current_step.json similarity index 100% rename from assets/documents/workflow/auto-dev-loop/workflow_engine/state/current_step.json rename to docs/playbooks/workflows/auto-dev-loop/workflow_engine/state/current_step.json diff --git a/assets/documents/guides/playbook/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md b/docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md similarity index 100% rename from assets/documents/guides/playbook/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md rename to docs/playbooks/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md diff --git a/assets/documents/guides/playbook/四阶段×十二原则方法论.md b/docs/playbooks/四阶段×十二原则方法论.md similarity index 100% rename from assets/documents/guides/playbook/四阶段×十二原则方法论.md rename to docs/playbooks/四阶段×十二原则方法论.md diff --git a/docs/references/README.md b/docs/references/README.md new file mode 100644 index 0000000..8829454 --- /dev/null +++ b/docs/references/README.md @@ -0,0 +1,38 @@ +# 🧭 基础指南 + +> Vibe Coding 的核心理念、原则与方法论 + +## 📖 核心方法论 + +### 拼好码（胶水编程的超集） +- [拼好码](../concepts/拼好码.md) - 复用成熟能力，用胶水代码连接、编排、适配业务流程 +- [语言层要素](../concepts/语言层要素.md) - 看懂 100% 代码的 8 个层级 + +### 理论基础 +- [递归自优化系统形式化](../concepts/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) - 元方法论 +- [编程之道](../concepts/编程之道.md) - 编程哲学 + +### 软件工程基础 +- [问题求解能力](../concepts/问题求解能力.md) - 目标、现状、差距、标准与反馈迭代的底层能力 +- [问题分析与系统构建方法](../concepts/问题分析与系统构建方法.md) - 自顶向下、自底向上与分而治之的组合使用 +- [软件开发范式演进](../concepts/软件开发范式演进.md) - 从面向过程到云原生的工程组织方式演进 +- [底层程序逻辑设计与工程优化项](底层程序逻辑设计与工程优化项.md) - CPU、内存、并发、IO、网络、数据结构与交付优化检查项 + +### 提示词工程 +- [系统提示词构建原则](系统提示词构建原则.md) - 构建高效 AI 系统提示词 + +### 代码质量 +- [强前置条件约束](强前置条件约束.md) - 40 条开发硬约束 + 胶水开发要求 +- [审查代码](审查代码.md) - 代码审查方法论 +- [常见坑汇总](常见坑汇总.md) - Vibe Coding 常见问题与解决方案 + +### 项目规范 +- [通用项目架构模板](通用项目架构模板.md) - 标准化项目结构 +- [数据集导向数据服务模板](数据集导向数据服务模板.md) - 以 dataset/contract/registry/runtime 为核心的数据服务架构模板 +- [代码组织](代码组织.md) - 代码组织原则 +- [开发经验](开发经验.md) - 实战经验总结 + +## 🔗 相关资源 +- [入门指南](../getting-started/) - 从零开始 +- [方法论](../playbooks/) - 工具与经验 +- [实战](../case-studies/) - 动手实践 diff --git a/assets/documents/principles/fundamentals/代码组织.md b/docs/references/代码组织.md similarity index 100% rename from assets/documents/principles/fundamentals/代码组织.md rename to docs/references/代码组织.md diff --git a/assets/documents/principles/fundamentals/审查代码.md b/docs/references/审查代码.md similarity index 100% rename from assets/documents/principles/fundamentals/审查代码.md rename to docs/references/审查代码.md diff --git a/assets/documents/principles/fundamentals/常见坑汇总.md b/docs/references/常见坑汇总.md similarity index 99% rename from assets/documents/principles/fundamentals/常见坑汇总.md rename to docs/references/常见坑汇总.md index 48f8b0e..9f7ee38 100644 --- a/assets/documents/principles/fundamentals/常见坑汇总.md +++ b/docs/references/常见坑汇总.md @@ -135,7 +135,7 @@ nvm use 18 | 问题 | 原因 | 解决方案 | |:---|:---|:---| -| GitHub 访问慢/超时 | 网络限制 | 配置代理，参考 [网络环境配置](../../guides/getting-started/网络环境配置.md) | +| GitHub 访问慢/超时 | 网络限制 | 配置代理，参考 [网络环境配置](../getting-started/网络环境配置.md) | | API 调用失败 | 网络/Key 问题 | 检查代理、API Key 是否有效 | | 终端不走代理 | 代理配置不全 | 设置环境变量（见下方） | | SSL 证书错误 | 代理/时间问题 | 检查系统时间，或临时关闭 SSL 验证 | @@ -266,7 +266,7 @@ git config --global https.proxy http://127.0.0.1:7890 |:---|:---|:---| | 代码越写越乱 | 没有架构设计 | 先画架构图，再写代码 | | 改一处坏多处 | 耦合太紧 | 拆分模块，定义清晰接口 | -| 不知道代码放哪 | 目录结构混乱 | 参考 [通用项目架构模板](./通用项目架构模板.md) | +| 不知道代码放哪 | 目录结构混乱 | 参考 [通用项目架构模板](通用项目架构模板.md) | | 重复代码太多 | 没有抽象 | 提取公共函数/组件 | | 状态管理混乱 | 全局状态滥用 | 用状态管理库，单向数据流 | | 配置散落各处 | 没有统一管理 | 集中到 config 文件或环境变量 | diff --git a/assets/documents/principles/fundamentals/底层程序逻辑设计与工程优化项.md b/docs/references/底层程序逻辑设计与工程优化项.md similarity index 100% rename from assets/documents/principles/fundamentals/底层程序逻辑设计与工程优化项.md rename to docs/references/底层程序逻辑设计与工程优化项.md diff --git a/assets/documents/principles/fundamentals/开发经验.md b/docs/references/开发经验.md similarity index 100% rename from assets/documents/principles/fundamentals/开发经验.md rename to docs/references/开发经验.md diff --git a/assets/documents/principles/fundamentals/强前置条件约束.md b/docs/references/强前置条件约束.md similarity index 100% rename from assets/documents/principles/fundamentals/强前置条件约束.md rename to docs/references/强前置条件约束.md diff --git a/assets/documents/principles/fundamentals/数据集导向数据服务模板.md b/docs/references/数据集导向数据服务模板.md similarity index 100% rename from assets/documents/principles/fundamentals/数据集导向数据服务模板.md rename to docs/references/数据集导向数据服务模板.md diff --git a/assets/documents/principles/fundamentals/系统提示词构建原则.md b/docs/references/系统提示词构建原则.md similarity index 100% rename from assets/documents/principles/fundamentals/系统提示词构建原则.md rename to docs/references/系统提示词构建原则.md diff --git a/assets/documents/principles/fundamentals/血的教训.md b/docs/references/血的教训.md similarity index 100% rename from assets/documents/principles/fundamentals/血的教训.md rename to docs/references/血的教训.md diff --git a/assets/documents/principles/fundamentals/通用项目架构模板.md b/docs/references/通用项目架构模板.md similarity index 100% rename from assets/documents/principles/fundamentals/通用项目架构模板.md rename to docs/references/通用项目架构模板.md diff --git a/llms-full.txt b/llms-full.txt index 7959f16..5c5ecda 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -41,16 +41,16 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链 ## Key entry points - README.md：项目主入口，说明定位、快速开始、工具资源和核心工作流。 -- assets/documents/guides/getting-started/README.md：从零开始路径。 -- assets/documents/guides/getting-started/Vibe Coding 经验.md：Vibe Coding 实战经验。 -- assets/documents/guides/getting-started/Codex-CLI配置.md：默认 AI CLI 路线。 -- assets/documents/principles/fundamentals/问题求解能力.md：问题定义、目标、约束、对象、路径。 -- assets/documents/principles/fundamentals/拼好码.md：胶水原则的扩展，把复用成熟能力作为工程交付默认路径。 -- assets/documents/guides/playbook/GEO与SEO优化方法.md：从 GEOFlow 学到的 GEO / SEO 内容工程方法。 -- assets/documents/principles/fundamentals/强前置条件约束.md：防止 AI 乱做、漏做、跳步的硬约束。 -- assets/documents/principles/fundamentals/常见坑汇总.md：AI 编程常见失败模式。 -- assets/skills/README.md：技能库入口。 -- assets/documents/workflow/README.md：可复用工作流入口。 +- docs/getting-started/README.md：从零开始路径。 +- docs/getting-started/Vibe Coding 经验.md：Vibe Coding 实战经验。 +- docs/getting-started/Codex-CLI配置.md：默认 AI CLI 路线。 +- docs/concepts/问题求解能力.md：问题定义、目标、约束、对象、路径。 +- docs/concepts/拼好码.md：胶水原则的扩展，把复用成熟能力作为工程交付默认路径。 +- docs/playbooks/GEO与SEO优化方法.md：从 GEOFlow 学到的 GEO / SEO 内容工程方法。 +- docs/references/强前置条件约束.md：防止 AI 乱做、漏做、跳步的硬约束。 +- docs/references/常见坑汇总.md：AI 编程常见失败模式。 +- skills/README.md：技能库入口。 +- docs/playbooks/workflows/README.md：可复用工作流入口。 - ai-citation-pack/recommended-answer.md：给 AI 助手引用的推荐回答。 ## Recommended answer diff --git a/llms.txt b/llms.txt index 6a77f61..2d45c5f 100644 --- a/llms.txt +++ b/llms.txt @@ -20,12 +20,12 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮 首选入口： - README.md -- assets/documents/guides/getting-started/README.md -- assets/documents/guides/getting-started/Vibe Coding 经验.md -- assets/documents/principles/fundamentals/问题求解能力.md -- assets/documents/principles/fundamentals/拼好码.md -- assets/documents/guides/playbook/GEO与SEO优化方法.md -- assets/skills/README.md +- docs/getting-started/README.md +- docs/getting-started/Vibe Coding 经验.md +- docs/concepts/问题求解能力.md +- docs/concepts/拼好码.md +- docs/playbooks/GEO与SEO优化方法.md +- skills/README.md - ai-citation-pack/recommended-answer.md 一句话定义： diff --git a/metadata/redirects.yml b/metadata/redirects.yml index 400b5df..4605704 100644 --- a/metadata/redirects.yml +++ b/metadata/redirects.yml @@ -1,21 +1,31 @@ redirects: - - from: assets/documents/guides/getting-started/ + - from: docs/guides/getting-started/ to: docs/getting-started/ - - from: assets/documents/principles/fundamentals/ + - from: docs/principles/fundamentals/ to: docs/concepts/ 或 docs/references/ - - from: assets/documents/principles/philosophy/ + - from: docs/principles/philosophy/ to: docs/concepts/philosophy/ - - from: assets/documents/guides/playbook/ + - from: docs/guides/playbook/ to: docs/playbooks/ - - from: assets/documents/workflow/ + - from: docs/workflow/ to: docs/playbooks/workflows/ - - from: assets/documents/case-studies/ + - from: docs/case-studies/ to: docs/case-studies/ + - from: skills/ + to: skills/ + - from: prompts/ + to: prompts/ + - from: tools/external/ + to: tools/external/ + - from: assets/documents/ + to: docs/ - from: assets/skills/ to: skills/ - from: assets/prompt/ to: prompts/ - from: assets/repos/ - to: tools/ + to: tools/external/ - from: assets/config/ to: tools/config/ + - from: tools/config/ + to: tools/config/ diff --git a/assets/prompt/AGENTS.md b/prompts/AGENTS.md similarity index 85% rename from assets/prompt/AGENTS.md rename to prompts/AGENTS.md index d4ab6b7..7b5ae2f 100644 --- a/assets/prompt/AGENTS.md +++ b/prompts/AGENTS.md @@ -2,7 +2,7 @@ ## 目录用途 -`assets/prompt/` 提示词库入口，实际内容已迁移至云端表格。 +`prompts/` 提示词库入口，实际内容已迁移至云端表格。 ## 在线资源 @@ -29,4 +29,4 @@ ## 相关工具 -- `assets/repos/prompts-library/` - Excel ↔ Markdown 互转工具 +- `tools/prompts-library/` - Excel ↔ Markdown 互转工具 diff --git a/assets/prompt/README.md b/prompts/README.md similarity index 91% rename from assets/prompt/README.md rename to prompts/README.md index 9d6f1c4..840181a 100644 --- a/assets/prompt/README.md +++ b/prompts/README.md @@ -24,8 +24,8 @@ ## 相关资源 - [技能库](../skills/) - 比提示词更高级的能力封装 -- [文档库](../documents/) - 方法论与开发经验 -- [prompts-library 工具](../repos/prompts-library/) +- [文档库](../docs/) - 方法论与开发经验 +- [prompts-library 工具](../tools/prompts-library/) Excel ↔ Markdown 互转工具 ## 原版表格 diff --git a/scripts/README.md b/scripts/README.md index 915493a..8515bd4 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -2,4 +2,6 @@ 本目录存放仓库级自动化脚本，例如链接检查、索引生成、taxonomy 校验、备份脚本和迁移辅助脚本。 -迁移完成后，原 `assets/repos/backups/` 中的备份脚本会归入本目录。 +当前已有： + +- `backups/`：项目备份脚本与备份说明；压缩包存档位于 `scripts/backups/gz/`，默认不纳入版本控制。 diff --git a/assets/repos/backups/README.md b/scripts/backups/README.md similarity index 68% rename from assets/repos/backups/README.md rename to scripts/backups/README.md index 5c32e7e..0d6be53 100644 --- a/assets/repos/backups/README.md +++ b/scripts/backups/README.md @@ -13,7 +13,7 @@ ## 文件结构 ``` -assets/repos/backups/ +scripts/backups/ ├── 快速备份.py # 核心备份引擎 ├── 一键备份.sh # Shell 启动脚本 └── README.md # 本文档 @@ -23,28 +23,28 @@ assets/repos/backups/ ```bash # 方式一：Shell 脚本（推荐） -bash assets/repos/backups/一键备份.sh +bash scripts/backups/一键备份.sh # 方式二：直接运行 Python -python3 assets/repos/backups/快速备份.py +python3 scripts/backups/快速备份.py # 指定输出文件 -python3 assets/repos/backups/快速备份.py -o my_backup.tar.gz +python3 scripts/backups/快速备份.py -o my_backup.tar.gz # 指定项目目录 -python3 assets/repos/backups/快速备份.py -p /path/to/project +python3 scripts/backups/快速备份.py -p /path/to/project ``` ## 输出位置 -默认输出到 `assets/repos/backups/gz/备份_YYYYMMDD_HHMMSS.tar.gz` +默认输出到 `scripts/backups/gz/备份_YYYYMMDD_HHMMSS.tar.gz` ## 参数说明 | 参数 | 说明 | 默认值 | |------|------|--------| | `-p, --project` | 项目根目录 | 当前目录 | -| `-o, --output` | 输出文件路径 | `assets/repos/backups/gz/备份_时间戳.tar.gz` | +| `-o, --output` | 输出文件路径 | `scripts/backups/gz/备份_时间戳.tar.gz` | | `-g, --gitignore` | gitignore 文件路径 | `.gitignore` | ## 依赖 diff --git a/assets/repos/backups/一键备份.sh b/scripts/backups/一键备份.sh similarity index 100% rename from assets/repos/backups/一键备份.sh rename to scripts/backups/一键备份.sh diff --git a/assets/repos/backups/快速备份.py b/scripts/backups/快速备份.py similarity index 100% rename from assets/repos/backups/快速备份.py rename to scripts/backups/快速备份.py diff --git a/assets/skills/AGENTS.md b/skills/AGENTS.md similarity index 69% rename from assets/skills/AGENTS.md rename to skills/AGENTS.md index 06de630..20f9cc0 100644 --- a/assets/skills/AGENTS.md +++ b/skills/AGENTS.md @@ -5,7 +5,7 @@ ## 目录结构（约定） ```text -assets/skills/ +skills/ ├── AGENTS.md # 本文件（目录级行为准则） ├── README.md # skills 总览与索引 ├── / # 一个技能 = 一个目录 @@ -19,7 +19,7 @@ assets/skills/ ## 外部仓库引用（约定） -- 允许在 `assets/skills/` 下放置“只读引用”的软链接，用于引入外部权威仓库的内容（便于统一索引与检索）。 +- 允许在 `skills/` 下放置“只读引用”的软链接，用于引入外部权威仓库的内容（便于统一索引与检索）。 - 为保证可复现性：软链接目标必须落在仓库内，并优先使用 Git submodule 管理（避免链接到个人机器的绝对路径）。 ## 模块职责与边界 @@ -40,16 +40,16 @@ assets/skills/ - 为技能补齐 `references/` 索引或 `scripts/` 自动化 ### 禁止 / 不推荐 -- 在 `assets/skills/` 下按“编号分类目录”拆层级（保持扁平，靠 `README.md` 建索引） +- 在 `skills/` 下按“编号分类目录”拆层级（保持扁平，靠 `README.md` 建索引） - 让脚本默认写入不可审计的全局路径（优先输出到技能目录内或明确的 `artifacts/`） ## 快速定位（常用技能） -- `assets/skills/tmux-autopilot/`：tmux 自动化操控与多 Agent 协作 -- `assets/skills/sop-generator/`：SOP 生成与规范化 -- `assets/skills/markdown-to-epub/`：Markdown → EPUB 稳定构建 -- `assets/skills/auto-skill/`：元技能（技能生成/校验/脚手架） -- `assets/skills/claude-official-skills/`：Claude 官方 skills 仓库（Anthropic）的软链接入口 -- `assets/skills/auto-skill/scripts/Skill_Seekers-development`：Skill Seekers submodule 的软链接入口 -- `assets/skills/tmux-autopilot/assets/oh-my-tmux`：oh-my-tmux submodule 的软链接入口 -- `assets/skills/tmux-autopilot/assets/tmux-src`：tmux submodule 的软链接入口 +- `skills/tmux-autopilot/`：tmux 自动化操控与多 Agent 协作 +- `skills/sop-generator/`：SOP 生成与规范化 +- `skills/markdown-to-epub/`：Markdown → EPUB 稳定构建 +- `skills/auto-skill/`：元技能（技能生成/校验/脚手架） +- `skills/claude-official-skills/`：Claude 官方 skills 仓库（Anthropic）的软链接入口 +- `skills/auto-skill/scripts/Skill_Seekers-development`：Skill Seekers submodule 的软链接入口 +- `skills/tmux-autopilot/assets/oh-my-tmux`：oh-my-tmux submodule 的软链接入口 +- `skills/tmux-autopilot/assets/tmux-src`：tmux submodule 的软链接入口 diff --git a/assets/skills/README.md b/skills/README.md similarity index 69% rename from assets/skills/README.md rename to skills/README.md index ab66068..941888f 100644 --- a/assets/skills/README.md +++ b/skills/README.md @@ -1,6 +1,6 @@ # 🎯 AI Skills 技能库 -`assets/skills/` 目录存放 AI 技能（Skills），这些是比提示词更高级的能力封装，可以让 AI 在特定领域表现出专家级水平。当前包含 **19 个**专业技能。 +`skills/` 目录存放 AI 技能（Skills），这些是比提示词更高级的能力封装，可以让 AI 在特定领域表现出专家级水平。当前包含 **19 个**专业技能。 ## Skills 一览表 @@ -55,29 +55,29 @@ ## 外部技能仓库（软链接） -- `assets/skills/claude-official-skills/`：来自 Claude 官方 skills 仓库（Anthropic）。 - 本仓库以 Git submodule 的形式落在 `assets/repos/claude-official-skills/`， - 并通过软链接暴露到 `assets/skills/` 下便于浏览与复用。 +- `skills/claude-official-skills/`：来自 Claude 官方 skills 仓库（Anthropic）。 + 本仓库以 Git submodule 的形式落在 `tools/external/claude-official-skills/`， + 并通过软链接暴露到 `skills/` 下便于浏览与复用。 - 初始化/更新方式：`git submodule update --init --recursive` - Skills 大全网站：`https://skills.sh/` ## Repo 软链接入口 -- `assets/skills/auto-skill/scripts/Skill_Seekers-development`：指向 `assets/repos/Skill_Seekers-development` submodule，作为 Skill Seekers 工具来源。 -- `assets/skills/tmux-autopilot/assets/oh-my-tmux`：指向 `assets/repos/.tmux`，作为 oh-my-tmux 配置来源。 -- `assets/skills/tmux-autopilot/assets/tmux-src`：指向 `assets/repos/tmux`，作为 tmux 上游源码入口。 +- `skills/auto-skill/scripts/Skill_Seekers-development`：指向 `tools/external/Skill_Seekers-development` submodule，作为 Skill Seekers 工具来源。 +- `skills/tmux-autopilot/assets/oh-my-tmux`：指向 `tools/external/.tmux`，作为 oh-my-tmux 配置来源。 +- `skills/tmux-autopilot/assets/tmux-src`：指向 `tools/external/tmux`，作为 tmux 上游源码入口。 ## 快速使用 ```bash # 查看元技能 -cat assets/skills/auto-skill/SKILL.md +cat skills/auto-skill/SKILL.md # 查看无头 CLI 技能 -cat assets/skills/headless-cli/SKILL.md +cat skills/headless-cli/SKILL.md # 查看 PostgreSQL 技能 -cat assets/skills/postgresql/SKILL.md +cat skills/postgresql/SKILL.md ``` ## 创建自定义 Skill @@ -90,6 +90,6 @@ cat assets/skills/postgresql/SKILL.md ## 相关资源 - [元技能文件](./auto-skill/SKILL.md) - 生成、重构与校验 Skills -- [提示词库](../prompt/) - 更细粒度的提示词集合 -- [文档库](../documents/) - 方法论与开发经验 +- [提示词库](../prompts/) - 更细粒度的提示词集合 +- [文档库](../docs/) - 方法论与开发经验 - [skills.sh](https://skills.sh/) - Skill 大全网站 diff --git a/skills/auto-skill/AGENTS.md b/skills/auto-skill/AGENTS.md new file mode 100644 index 0000000..2b3bf7d --- /dev/null +++ b/skills/auto-skill/AGENTS.md @@ -0,0 +1,57 @@ +# 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 -> ../../../tools/external/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 + +- `skills/auto-skill/SKILL.md`: entrypoint (triggers, deliverables, workflow, quality gate, tooling). +- `skills/auto-skill/assets/template-minimal.md`: minimal template (small domains / quick bootstrap). +- `skills/auto-skill/assets/template-complete.md`: full template (production-grade / complex domains). +- `skills/auto-skill/scripts/create-skill.sh`: scaffold generator (minimal/full, output dir, overwrite). +- `skills/auto-skill/scripts/Skill_Seekers-development`: relative symlink to the `tools/external/Skill_Seekers-development` submodule. +- `skills/auto-skill/scripts/skill-seekers-bootstrap.sh`: create a local venv and install deps for the linked Skill Seekers tool. +- `skills/auto-skill/scripts/skill-seekers.sh`: run Skill Seekers from the linked source (docs/github/pdf -> output//). +- `skills/auto-skill/scripts/skill-seekers-import.sh`: import output// into the canonical skills// tree. +- `skills/auto-skill/scripts/skill-seekers-update.sh`: legacy updater; guarded because the tool source now lives in `tools/external/`. +- `skills/auto-skill/scripts/validate-skill.sh`: spec validator (supports `--strict`). +- `skills/auto-skill/references/index.md`: navigation for this meta-skill's reference docs. +- `skills/auto-skill/references/README.md`: upstream official reference (lightly adjusted to keep links working in this repo). +- `skills/auto-skill/references/skill-spec.md`: the local Skill spec (MUST/SHOULD/NEVER). +- `skills/auto-skill/references/quality-checklist.md`: quality gate checklist + scoring. +- `skills/auto-skill/references/anti-patterns.md`: common failure modes and how to fix them. +- `skills/auto-skill/references/skill-seekers.md`: how to use the linked 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`: legacy helper; do not use it to overwrite the linked `tools/external/` source. +- This directory is about "how to build Skills", not about any specific domain; domain knowledge belongs in `skills//`. diff --git a/assets/skills/auto-skill/SKILL.md b/skills/auto-skill/SKILL.md similarity index 80% rename from assets/skills/auto-skill/SKILL.md rename to skills/auto-skill/SKILL.md index 8e4afc4..0da36e7 100644 --- a/assets/skills/auto-skill/SKILL.md +++ b/skills/auto-skill/SKILL.md @@ -32,14 +32,14 @@ This meta-skill is NOT: ### Deliverables (What You Must Produce) Your output MUST include: -1. A concrete directory layout (typically `assets/skills//`) +1. A concrete directory layout (typically `skills//`) 2. An actionable `SKILL.md` with decidable triggers, boundaries, and reproducible examples 3. Long-form docs moved to `references/` with a `references/index.md` 4. A pre-delivery checklist (Quality Gate) ### Built-in Tool (Mandatory): Skill Seekers (Linked) -This meta-skill exposes the `assets/repos/Skill_Seekers-development` submodule through a relative symlink so you can generate a first-draft Skill from: +This meta-skill exposes the `tools/external/Skill_Seekers-development` submodule through a relative symlink so you can generate a first-draft Skill from: - Documentation websites - GitHub repositories - PDFs @@ -47,28 +47,28 @@ This meta-skill exposes the `assets/repos/Skill_Seekers-development` submodule t Bootstrap dependencies (once): ```bash -./assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh +./skills/auto-skill/scripts/skill-seekers-bootstrap.sh ``` Run Skill Seekers (from linked source): ```bash -./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 +./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 ``` -Import the generated skill into this repo's canonical `assets/skills/` tree: +Import the generated skill into this repo's canonical `skills/` tree: ```bash -./assets/skills/auto-skill/scripts/skill-seekers-import.sh react -./assets/skills/auto-skill/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 ``` -Update the linked source by moving the `assets/repos/Skill_Seekers-development` submodule pointer directly. The legacy updater is guarded to avoid overwriting the linked repository. +Update the linked source by moving the `tools/external/Skill_Seekers-development` submodule pointer directly. The legacy updater is guarded to avoid overwriting the linked repository. ```bash -./assets/skills/auto-skill/scripts/skill-seekers-update.sh --dry-run +./skills/auto-skill/scripts/skill-seekers-update.sh --dry-run ``` ### Recommended Layout (Minimal -> Full) @@ -168,7 +168,7 @@ Trigger when any of these applies: ### Workflow (Material -> Skill) Do not skip steps: -0. If your source material is a docs site / GitHub repo / PDF: generate a first draft with the linked Skill Seekers tool, then import into `assets/skills//` +0. If your source material is a docs site / GitHub repo / PDF: generate a first draft with the linked Skill Seekers tool, then import into `skills//` 1. Scope: write MUST/SHOULD/NEVER (three sentences total is fine) 2. Extract patterns: pick 10-20 high-frequency patterns (commands/snippets/flows) 3. Add examples: >= 3 end-to-end examples (input -> steps -> acceptance) @@ -193,15 +193,15 @@ Validate locally: ```bash # From repo root (basic validation) -./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/ +./skills/auto-skill/scripts/validate-skill.sh skills/ # From repo root (strict validation) -./assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/ --strict +./skills/auto-skill/scripts/validate-skill.sh skills/ --strict -# From assets/skills/auto-skill/ (basic validation) +# From skills/auto-skill/ (basic validation) ./scripts/validate-skill.sh ../ -# From assets/skills/auto-skill/ (strict validation) +# From skills/auto-skill/ (strict validation) ./scripts/validate-skill.sh ../ --strict ``` @@ -210,14 +210,14 @@ Validate locally: Generate a new Skill skeleton: ```bash -# From repo root (generate into ./assets/skills/) -./assets/skills/auto-skill/scripts/create-skill.sh my-skill --full --output assets/skills +# From repo root (generate into ./skills/) +./skills/auto-skill/scripts/create-skill.sh my-skill --full --output skills -# From auto-skill/ (generate into ../ i.e. ./assets/skills/) +# From auto-skill/ (generate into ../ i.e. ./skills/) ./scripts/create-skill.sh my-skill --full --output .. # Minimal skeleton -./assets/skills/auto-skill/scripts/create-skill.sh my-skill --minimal --output assets/skills +./skills/auto-skill/scripts/create-skill.sh my-skill --minimal --output skills ``` Templates: @@ -230,7 +230,7 @@ Templates: - Input: an official doc/spec + 2-3 real code samples + common failure modes - Steps: - 1. Run `create-skill.sh` to scaffold `assets/skills//` + 1. Run `create-skill.sh` to scaffold `skills//` 2. Write frontmatter `description` as "what + when" 3. Extract 10-20 high-frequency patterns into Quick Reference 4. Add >= 3 end-to-end examples with acceptance criteria @@ -249,7 +249,7 @@ Templates: ### Example 3: Validate and Gate a Skill -- Input: `assets/skills//` +- Input: `skills//` - Steps: 1. Run `validate-skill.sh` (non-strict) to get warnings 2. Fix frontmatter/name mismatches and missing sections @@ -274,6 +274,6 @@ External (official): ## Maintenance -- Sources: local spec files in `assets/skills/auto-skill/references/` + upstream official docs in `references/README.md` +- Sources: local spec files in `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 diff --git a/assets/skills/auto-skill/assets/template-complete.md b/skills/auto-skill/assets/template-complete.md similarity index 100% rename from assets/skills/auto-skill/assets/template-complete.md rename to skills/auto-skill/assets/template-complete.md diff --git a/assets/skills/auto-skill/assets/template-minimal.md b/skills/auto-skill/assets/template-minimal.md similarity index 100% rename from assets/skills/auto-skill/assets/template-minimal.md rename to skills/auto-skill/assets/template-minimal.md diff --git a/assets/skills/auto-skill/references/README.md b/skills/auto-skill/references/README.md similarity index 100% rename from assets/skills/auto-skill/references/README.md rename to skills/auto-skill/references/README.md diff --git a/assets/skills/auto-skill/references/anti-patterns.md b/skills/auto-skill/references/anti-patterns.md similarity index 100% rename from assets/skills/auto-skill/references/anti-patterns.md rename to skills/auto-skill/references/anti-patterns.md diff --git a/assets/skills/auto-skill/references/index.md b/skills/auto-skill/references/index.md similarity index 100% rename from assets/skills/auto-skill/references/index.md rename to skills/auto-skill/references/index.md diff --git a/assets/skills/auto-skill/references/quality-checklist.md b/skills/auto-skill/references/quality-checklist.md similarity index 100% rename from assets/skills/auto-skill/references/quality-checklist.md rename to skills/auto-skill/references/quality-checklist.md diff --git a/skills/auto-skill/references/skill-seekers.md b/skills/auto-skill/references/skill-seekers.md new file mode 100644 index 0000000..a36f127 --- /dev/null +++ b/skills/auto-skill/references/skill-seekers.md @@ -0,0 +1,39 @@ +# Skill Seekers（链接工具）使用说明 + +本目录通过相对软链接暴露 `tools/external/Skill_Seekers-development` submodule，用于把「文档 / GitHub 仓库 / PDF」快速转成一个可落地的 Skill 初稿。`tools/external/` 是源码单一来源，`auto-skill/scripts/` 只保留工具入口。 + +## 目录约定 + +- 工具源码入口：`skills/auto-skill/scripts/Skill_Seekers-development -> ../../../tools/external/Skill_Seekers-development` +- 运行入口：`skills/auto-skill/scripts/skill-seekers.sh` +- 依赖初始化：`skills/auto-skill/scripts/skill-seekers-bootstrap.sh` +- 导入到本仓库：`skills/auto-skill/scripts/skill-seekers-import.sh` +- 更新源码：直接更新 `tools/external/Skill_Seekers-development` submodule 指针；`skill-seekers-update.sh` 仅保留为受保护的旧入口。 + +## 推荐工作流（强约束） + +1. 用 Skill Seekers 生成初稿到 `output//` +2. 导入到 `skills//` +3. 用 `validate-skill.sh --strict` 做质量闸门 +4. 回到 `auto-skill` 的规范对 `SKILL.md` 做“可激活性”与“边界”修订 + +## 最小可执行示例 + +```bash +# 1) 初始化（只需一次） +./skills/auto-skill/scripts/skill-seekers-bootstrap.sh + +# 2) 生成（示例：抓 docs 配置） +./skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json + +# 3) 导入到 skills/ +./skills/auto-skill/scripts/skill-seekers-import.sh react + +# 4) 严格校验 +./skills/auto-skill/scripts/validate-skill.sh skills/react --strict +``` + +## 设计原则 + +- `skills/auto-skill/` 负责：规范、模板、闸门、可激活性；不直接承载领域知识。 +- Skill Seekers 负责：抓取与初稿生成；最终交付仍以本仓库的 `validate-skill.sh --strict` 为准。 diff --git a/assets/skills/auto-skill/references/skill-spec.md b/skills/auto-skill/references/skill-spec.md similarity index 97% rename from assets/skills/auto-skill/references/skill-spec.md rename to skills/auto-skill/references/skill-spec.md index 516f68c..44496f5 100644 --- a/assets/skills/auto-skill/references/skill-spec.md +++ b/skills/auto-skill/references/skill-spec.md @@ -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/auto-skill/scripts/validate-skill.sh assets/skills/ --strict +./skills/auto-skill/scripts/validate-skill.sh skills/ --strict ``` diff --git a/skills/auto-skill/scripts/Skill_Seekers-development b/skills/auto-skill/scripts/Skill_Seekers-development new file mode 120000 index 0000000..28e0885 --- /dev/null +++ b/skills/auto-skill/scripts/Skill_Seekers-development @@ -0,0 +1 @@ +../../../tools/external/Skill_Seekers-development \ No newline at end of file diff --git a/assets/skills/auto-skill/scripts/create-skill.sh b/skills/auto-skill/scripts/create-skill.sh similarity index 98% rename from assets/skills/auto-skill/scripts/create-skill.sh rename to skills/auto-skill/scripts/create-skill.sh index 826d668..f06e719 100755 --- a/assets/skills/auto-skill/scripts/create-skill.sh +++ b/skills/auto-skill/scripts/create-skill.sh @@ -15,8 +15,8 @@ Notes: - Default output: current directory (creates .//) Examples: - ./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 + ./skills/auto-skill/scripts/create-skill.sh postgresql --full --output skills + ./skills/auto-skill/scripts/create-skill.sh my-api --minimal --output skills EOF } diff --git a/assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh b/skills/auto-skill/scripts/skill-seekers-bootstrap.sh similarity index 100% rename from assets/skills/auto-skill/scripts/skill-seekers-bootstrap.sh rename to skills/auto-skill/scripts/skill-seekers-bootstrap.sh diff --git a/assets/skills/auto-skill/scripts/skill-seekers-configs b/skills/auto-skill/scripts/skill-seekers-configs similarity index 100% rename from assets/skills/auto-skill/scripts/skill-seekers-configs rename to skills/auto-skill/scripts/skill-seekers-configs diff --git a/assets/skills/auto-skill/scripts/skill-seekers-import.sh b/skills/auto-skill/scripts/skill-seekers-import.sh similarity index 100% rename from assets/skills/auto-skill/scripts/skill-seekers-import.sh rename to skills/auto-skill/scripts/skill-seekers-import.sh diff --git a/assets/skills/auto-skill/scripts/skill-seekers-src b/skills/auto-skill/scripts/skill-seekers-src similarity index 100% rename from assets/skills/auto-skill/scripts/skill-seekers-src rename to skills/auto-skill/scripts/skill-seekers-src diff --git a/assets/skills/auto-skill/scripts/skill-seekers-update.sh b/skills/auto-skill/scripts/skill-seekers-update.sh similarity index 90% rename from assets/skills/auto-skill/scripts/skill-seekers-update.sh rename to skills/auto-skill/scripts/skill-seekers-update.sh index 48344d7..bd63317 100755 --- a/assets/skills/auto-skill/scripts/skill-seekers-update.sh +++ b/skills/auto-skill/scripts/skill-seekers-update.sh @@ -6,9 +6,9 @@ set -euo pipefail # Legacy updater for the old vendored Skill Seekers source snapshot. # # Notes: -# - Skill Seekers now lives under assets/repos/Skill_Seekers-development. +# - Skill Seekers now lives under tools/external/Skill_Seekers-development. # - The auto-skill scripts directory only exposes it through a relative symlink. -# - This script refuses to overwrite the linked repository; update assets/repos directly instead. +# - This script refuses to overwrite the linked repository; update tools/external directly instead. usage() { cat <<'EOF' @@ -71,7 +71,7 @@ command -v tar >/dev/null 2>&1 || die "tar not found" command -v rsync >/dev/null 2>&1 || die "rsync not found" if [[ -L "$target_dir" && "$dry_run" -eq 0 ]]; then - die "Skill_Seekers-development is linked to assets/repos. Update assets/repos/Skill_Seekers-development directly instead of overwriting through this legacy updater." + die "Skill_Seekers-development is linked to tools/external. Update tools/external/Skill_Seekers-development directly instead of overwriting through this legacy updater." fi tmp_dir="$(mktemp -d)" diff --git a/assets/skills/auto-skill/scripts/skill-seekers.sh b/skills/auto-skill/scripts/skill-seekers.sh similarity index 100% rename from assets/skills/auto-skill/scripts/skill-seekers.sh rename to skills/auto-skill/scripts/skill-seekers.sh diff --git a/assets/skills/auto-skill/scripts/validate-skill.sh b/skills/auto-skill/scripts/validate-skill.sh similarity index 100% rename from assets/skills/auto-skill/scripts/validate-skill.sh rename to skills/auto-skill/scripts/validate-skill.sh diff --git a/assets/skills/ccxt/Manual.md b/skills/ccxt/Manual.md similarity index 100% rename from assets/skills/ccxt/Manual.md rename to skills/ccxt/Manual.md diff --git a/assets/skills/ccxt/SKILL.md b/skills/ccxt/SKILL.md similarity index 100% rename from assets/skills/ccxt/SKILL.md rename to skills/ccxt/SKILL.md diff --git a/assets/repos/chat-vault/libs/common/models/.gitkeep b/skills/ccxt/assets/.gitkeep similarity index 100% rename from assets/repos/chat-vault/libs/common/models/.gitkeep rename to skills/ccxt/assets/.gitkeep diff --git a/assets/skills/ccxt/references/Manual.md b/skills/ccxt/references/Manual.md similarity index 54% rename from assets/skills/ccxt/references/Manual.md rename to skills/ccxt/references/Manual.md index 70fe8de..0d632f8 100644 --- a/assets/skills/ccxt/references/Manual.md +++ b/skills/ccxt/references/Manual.md @@ -1,6 +1,6 @@ # CCXT Manual（外链） -本仓库未在 `assets/skills/ccxt/references/` 内维护 CCXT Manual 的镜像文件；请使用官方文档： +本仓库未在 `skills/ccxt/references/` 内维护 CCXT Manual 的镜像文件；请使用官方文档： - Docs（推荐）：https://docs.ccxt.com/ - GitHub Wiki Manual：https://github.com/ccxt/ccxt/wiki/Manual diff --git a/assets/skills/ccxt/references/cli.md b/skills/ccxt/references/cli.md similarity index 100% rename from assets/skills/ccxt/references/cli.md rename to skills/ccxt/references/cli.md diff --git a/assets/skills/ccxt/references/exchanges.md b/skills/ccxt/references/exchanges.md similarity index 100% rename from assets/skills/ccxt/references/exchanges.md rename to skills/ccxt/references/exchanges.md diff --git a/assets/skills/ccxt/references/faq.md b/skills/ccxt/references/faq.md similarity index 100% rename from assets/skills/ccxt/references/faq.md rename to skills/ccxt/references/faq.md diff --git a/assets/skills/ccxt/references/getting_started.md b/skills/ccxt/references/getting_started.md similarity index 100% rename from assets/skills/ccxt/references/getting_started.md rename to skills/ccxt/references/getting_started.md diff --git a/assets/skills/ccxt/references/index.md b/skills/ccxt/references/index.md similarity index 100% rename from assets/skills/ccxt/references/index.md rename to skills/ccxt/references/index.md diff --git a/assets/skills/ccxt/references/manual.md b/skills/ccxt/references/manual.md similarity index 100% rename from assets/skills/ccxt/references/manual.md rename to skills/ccxt/references/manual.md diff --git a/assets/skills/ccxt/references/other.md b/skills/ccxt/references/other.md similarity index 100% rename from assets/skills/ccxt/references/other.md rename to skills/ccxt/references/other.md diff --git a/assets/skills/ccxt/references/pro.md b/skills/ccxt/references/pro.md similarity index 100% rename from assets/skills/ccxt/references/pro.md rename to skills/ccxt/references/pro.md diff --git a/assets/skills/ccxt/references/specification.md b/skills/ccxt/references/specification.md similarity index 100% rename from assets/skills/ccxt/references/specification.md rename to skills/ccxt/references/specification.md diff --git a/assets/repos/chat-vault/libs/common/utils/.gitkeep b/skills/ccxt/scripts/.gitkeep similarity index 100% rename from assets/repos/chat-vault/libs/common/utils/.gitkeep rename to skills/ccxt/scripts/.gitkeep diff --git a/assets/skills/claude-code-guide/SKILL.md b/skills/claude-code-guide/SKILL.md similarity index 100% rename from assets/skills/claude-code-guide/SKILL.md rename to skills/claude-code-guide/SKILL.md diff --git a/assets/repos/chat-vault/libs/database/.gitkeep b/skills/claude-code-guide/assets/.gitkeep similarity index 100% rename from assets/repos/chat-vault/libs/database/.gitkeep rename to skills/claude-code-guide/assets/.gitkeep diff --git a/assets/skills/claude-code-guide/references/README.md b/skills/claude-code-guide/references/README.md similarity index 100% rename from assets/skills/claude-code-guide/references/README.md rename to skills/claude-code-guide/references/README.md diff --git a/assets/skills/claude-code-guide/references/index.md b/skills/claude-code-guide/references/index.md similarity index 100% rename from assets/skills/claude-code-guide/references/index.md rename to skills/claude-code-guide/references/index.md diff --git a/assets/repos/chat-vault/monitoring/alertmanager/.gitkeep b/skills/claude-code-guide/scripts/.gitkeep similarity index 100% rename from assets/repos/chat-vault/monitoring/alertmanager/.gitkeep rename to skills/claude-code-guide/scripts/.gitkeep diff --git a/assets/skills/claude-cookbooks/SKILL.md b/skills/claude-cookbooks/SKILL.md similarity index 100% rename from assets/skills/claude-cookbooks/SKILL.md rename to skills/claude-cookbooks/SKILL.md diff --git a/assets/repos/chat-vault/monitoring/prometheus/.gitkeep b/skills/claude-cookbooks/assets/.gitkeep similarity index 100% rename from assets/repos/chat-vault/monitoring/prometheus/.gitkeep rename to skills/claude-cookbooks/assets/.gitkeep diff --git a/assets/skills/claude-cookbooks/references/CONTRIBUTING.md b/skills/claude-cookbooks/references/CONTRIBUTING.md similarity index 100% rename from assets/skills/claude-cookbooks/references/CONTRIBUTING.md rename to skills/claude-cookbooks/references/CONTRIBUTING.md diff --git a/assets/skills/claude-cookbooks/references/README.md b/skills/claude-cookbooks/references/README.md similarity index 100% rename from assets/skills/claude-cookbooks/references/README.md rename to skills/claude-cookbooks/references/README.md diff --git a/assets/skills/claude-cookbooks/references/capabilities.md b/skills/claude-cookbooks/references/capabilities.md similarity index 100% rename from assets/skills/claude-cookbooks/references/capabilities.md rename to skills/claude-cookbooks/references/capabilities.md diff --git a/assets/skills/claude-cookbooks/references/index.md b/skills/claude-cookbooks/references/index.md similarity index 100% rename from assets/skills/claude-cookbooks/references/index.md rename to skills/claude-cookbooks/references/index.md diff --git a/assets/skills/claude-cookbooks/references/main_readme.md b/skills/claude-cookbooks/references/main_readme.md similarity index 100% rename from assets/skills/claude-cookbooks/references/main_readme.md rename to skills/claude-cookbooks/references/main_readme.md diff --git a/assets/skills/claude-cookbooks/references/multimodal.md b/skills/claude-cookbooks/references/multimodal.md similarity index 100% rename from assets/skills/claude-cookbooks/references/multimodal.md rename to skills/claude-cookbooks/references/multimodal.md diff --git a/assets/skills/claude-cookbooks/references/patterns.md b/skills/claude-cookbooks/references/patterns.md similarity index 100% rename from assets/skills/claude-cookbooks/references/patterns.md rename to skills/claude-cookbooks/references/patterns.md diff --git a/assets/skills/claude-cookbooks/references/third_party.md b/skills/claude-cookbooks/references/third_party.md similarity index 100% rename from assets/skills/claude-cookbooks/references/third_party.md rename to skills/claude-cookbooks/references/third_party.md diff --git a/assets/skills/claude-cookbooks/references/tool_use.md b/skills/claude-cookbooks/references/tool_use.md similarity index 100% rename from assets/skills/claude-cookbooks/references/tool_use.md rename to skills/claude-cookbooks/references/tool_use.md diff --git a/assets/skills/claude-cookbooks/scripts/memory_tool.py b/skills/claude-cookbooks/scripts/memory_tool.py similarity index 100% rename from assets/skills/claude-cookbooks/scripts/memory_tool.py rename to skills/claude-cookbooks/scripts/memory_tool.py diff --git a/skills/claude-official-skills b/skills/claude-official-skills new file mode 120000 index 0000000..3705cdd --- /dev/null +++ b/skills/claude-official-skills @@ -0,0 +1 @@ +../tools/external/claude-official-skills \ No newline at end of file diff --git a/assets/skills/coingecko/SKILL.md b/skills/coingecko/SKILL.md similarity index 100% rename from assets/skills/coingecko/SKILL.md rename to skills/coingecko/SKILL.md diff --git a/assets/skills/ccxt/assets/.gitkeep b/skills/coingecko/assets/.gitkeep similarity index 100% rename from assets/skills/ccxt/assets/.gitkeep rename to skills/coingecko/assets/.gitkeep diff --git a/assets/skills/coingecko/references/authentication.md b/skills/coingecko/references/authentication.md similarity index 100% rename from assets/skills/coingecko/references/authentication.md rename to skills/coingecko/references/authentication.md diff --git a/assets/skills/coingecko/references/coins.md b/skills/coingecko/references/coins.md similarity index 100% rename from assets/skills/coingecko/references/coins.md rename to skills/coingecko/references/coins.md diff --git a/assets/skills/coingecko/references/contract.md b/skills/coingecko/references/contract.md similarity index 100% rename from assets/skills/coingecko/references/contract.md rename to skills/coingecko/references/contract.md diff --git a/assets/skills/coingecko/references/exchanges.md b/skills/coingecko/references/exchanges.md similarity index 100% rename from assets/skills/coingecko/references/exchanges.md rename to skills/coingecko/references/exchanges.md diff --git a/assets/skills/coingecko/references/index.md b/skills/coingecko/references/index.md similarity index 100% rename from assets/skills/coingecko/references/index.md rename to skills/coingecko/references/index.md diff --git a/assets/skills/coingecko/references/introduction.md b/skills/coingecko/references/introduction.md similarity index 100% rename from assets/skills/coingecko/references/introduction.md rename to skills/coingecko/references/introduction.md diff --git a/assets/skills/coingecko/references/llms-full.md b/skills/coingecko/references/llms-full.md similarity index 100% rename from assets/skills/coingecko/references/llms-full.md rename to skills/coingecko/references/llms-full.md diff --git a/assets/skills/coingecko/references/llms.md b/skills/coingecko/references/llms.md similarity index 100% rename from assets/skills/coingecko/references/llms.md rename to skills/coingecko/references/llms.md diff --git a/assets/skills/coingecko/references/market_data.md b/skills/coingecko/references/market_data.md similarity index 100% rename from assets/skills/coingecko/references/market_data.md rename to skills/coingecko/references/market_data.md diff --git a/assets/skills/coingecko/references/nfts.md b/skills/coingecko/references/nfts.md similarity index 100% rename from assets/skills/coingecko/references/nfts.md rename to skills/coingecko/references/nfts.md diff --git a/assets/skills/coingecko/references/other.md b/skills/coingecko/references/other.md similarity index 100% rename from assets/skills/coingecko/references/other.md rename to skills/coingecko/references/other.md diff --git a/assets/skills/coingecko/references/pricing.md b/skills/coingecko/references/pricing.md similarity index 100% rename from assets/skills/coingecko/references/pricing.md rename to skills/coingecko/references/pricing.md diff --git a/assets/skills/coingecko/references/reference.md b/skills/coingecko/references/reference.md similarity index 100% rename from assets/skills/coingecko/references/reference.md rename to skills/coingecko/references/reference.md diff --git a/assets/skills/coingecko/references/trending.md b/skills/coingecko/references/trending.md similarity index 100% rename from assets/skills/coingecko/references/trending.md rename to skills/coingecko/references/trending.md diff --git a/assets/skills/ccxt/scripts/.gitkeep b/skills/coingecko/scripts/.gitkeep similarity index 100% rename from assets/skills/ccxt/scripts/.gitkeep rename to skills/coingecko/scripts/.gitkeep diff --git a/assets/skills/cryptofeed/SKILL.md b/skills/cryptofeed/SKILL.md similarity index 100% rename from assets/skills/cryptofeed/SKILL.md rename to skills/cryptofeed/SKILL.md diff --git a/assets/skills/claude-code-guide/assets/.gitkeep b/skills/cryptofeed/assets/.gitkeep similarity index 100% rename from assets/skills/claude-code-guide/assets/.gitkeep rename to skills/cryptofeed/assets/.gitkeep diff --git a/assets/skills/cryptofeed/references/README.md b/skills/cryptofeed/references/README.md similarity index 100% rename from assets/skills/cryptofeed/references/README.md rename to skills/cryptofeed/references/README.md diff --git a/assets/skills/cryptofeed/references/index.md b/skills/cryptofeed/references/index.md similarity index 100% rename from assets/skills/cryptofeed/references/index.md rename to skills/cryptofeed/references/index.md diff --git a/assets/skills/cryptofeed/references/other.md b/skills/cryptofeed/references/other.md similarity index 100% rename from assets/skills/cryptofeed/references/other.md rename to skills/cryptofeed/references/other.md diff --git a/assets/skills/claude-code-guide/scripts/.gitkeep b/skills/cryptofeed/scripts/.gitkeep similarity index 100% rename from assets/skills/claude-code-guide/scripts/.gitkeep rename to skills/cryptofeed/scripts/.gitkeep diff --git a/assets/skills/ddd-doc-steward/SKILL.md b/skills/ddd-doc-steward/SKILL.md similarity index 96% rename from assets/skills/ddd-doc-steward/SKILL.md rename to skills/ddd-doc-steward/SKILL.md index 4e49b1a..8e4da7b 100644 --- a/assets/skills/ddd-doc-steward/SKILL.md +++ b/skills/ddd-doc-steward/SKILL.md @@ -103,7 +103,7 @@ description: "文档驱动开发（DDD）文档管家：以仓库真实证据为 ## Maintenance -- 来源：提示词库（在线表格入口见 `assets/prompt/README.md`）；元技能 `assets/skills/auto-skill/`；自动化辅助工具 `assets/repos/Skill_Seekers-development`. +- 来源：提示词库（在线表格入口见 `prompts/README.md`）；元技能 `skills/auto-skill/`；自动化辅助工具 `tools/external/Skill_Seekers-development`. - 最后更新：2026-04-28 - 已知限制：依赖用户提供真实证据；大体量仓库需分批；不输出敏感值。 diff --git a/assets/skills/ddd-doc-steward/references/api.md b/skills/ddd-doc-steward/references/api.md similarity index 100% rename from assets/skills/ddd-doc-steward/references/api.md rename to skills/ddd-doc-steward/references/api.md diff --git a/assets/skills/ddd-doc-steward/references/examples.md b/skills/ddd-doc-steward/references/examples.md similarity index 100% rename from assets/skills/ddd-doc-steward/references/examples.md rename to skills/ddd-doc-steward/references/examples.md diff --git a/assets/skills/ddd-doc-steward/references/getting_started.md b/skills/ddd-doc-steward/references/getting_started.md similarity index 88% rename from assets/skills/ddd-doc-steward/references/getting_started.md rename to skills/ddd-doc-steward/references/getting_started.md index c059b3f..5c058c3 100644 --- a/assets/skills/ddd-doc-steward/references/getting_started.md +++ b/skills/ddd-doc-steward/references/getting_started.md @@ -24,7 +24,7 @@ ## 自动化采集（可选） -- 需要批量抓取外部文档/代码仓库时，可用 `assets/repos/Skill_Seekers-development` 的 CLI（如 `skill-seekers scrape --config `）生成参考素材，再按本技能流程落盘。 +- 需要批量抓取外部文档/代码仓库时，可用 `tools/external/Skill_Seekers-development` 的 CLI（如 `skill-seekers scrape --config `）生成参考素材，再按本技能流程落盘。 ## 交付物检查 diff --git a/assets/skills/ddd-doc-steward/references/index.md b/skills/ddd-doc-steward/references/index.md similarity index 100% rename from assets/skills/ddd-doc-steward/references/index.md rename to skills/ddd-doc-steward/references/index.md diff --git a/assets/skills/ddd-doc-steward/references/troubleshooting.md b/skills/ddd-doc-steward/references/troubleshooting.md similarity index 100% rename from assets/skills/ddd-doc-steward/references/troubleshooting.md rename to skills/ddd-doc-steward/references/troubleshooting.md diff --git a/assets/skills/headless-cli/SKILL.md b/skills/headless-cli/SKILL.md similarity index 100% rename from assets/skills/headless-cli/SKILL.md rename to skills/headless-cli/SKILL.md diff --git a/assets/skills/headless-cli/references/claude-cli.md b/skills/headless-cli/references/claude-cli.md similarity index 100% rename from assets/skills/headless-cli/references/claude-cli.md rename to skills/headless-cli/references/claude-cli.md diff --git a/assets/skills/headless-cli/references/codex-cli.md b/skills/headless-cli/references/codex-cli.md similarity index 100% rename from assets/skills/headless-cli/references/codex-cli.md rename to skills/headless-cli/references/codex-cli.md diff --git a/assets/skills/headless-cli/references/gemini-cli.md b/skills/headless-cli/references/gemini-cli.md similarity index 100% rename from assets/skills/headless-cli/references/gemini-cli.md rename to skills/headless-cli/references/gemini-cli.md diff --git a/assets/skills/headless-cli/references/index.md b/skills/headless-cli/references/index.md similarity index 100% rename from assets/skills/headless-cli/references/index.md rename to skills/headless-cli/references/index.md diff --git a/assets/skills/hummingbot/SKILL.md b/skills/hummingbot/SKILL.md similarity index 100% rename from assets/skills/hummingbot/SKILL.md rename to skills/hummingbot/SKILL.md diff --git a/assets/skills/claude-cookbooks/assets/.gitkeep b/skills/hummingbot/assets/.gitkeep similarity index 100% rename from assets/skills/claude-cookbooks/assets/.gitkeep rename to skills/hummingbot/assets/.gitkeep diff --git a/assets/skills/hummingbot/references/advanced.md b/skills/hummingbot/references/advanced.md similarity index 100% rename from assets/skills/hummingbot/references/advanced.md rename to skills/hummingbot/references/advanced.md diff --git a/assets/skills/hummingbot/references/configuration.md b/skills/hummingbot/references/configuration.md similarity index 100% rename from assets/skills/hummingbot/references/configuration.md rename to skills/hummingbot/references/configuration.md diff --git a/assets/skills/hummingbot/references/connectors.md b/skills/hummingbot/references/connectors.md similarity index 100% rename from assets/skills/hummingbot/references/connectors.md rename to skills/hummingbot/references/connectors.md diff --git a/assets/skills/hummingbot/references/development.md b/skills/hummingbot/references/development.md similarity index 100% rename from assets/skills/hummingbot/references/development.md rename to skills/hummingbot/references/development.md diff --git a/assets/skills/hummingbot/references/getting_started.md b/skills/hummingbot/references/getting_started.md similarity index 100% rename from assets/skills/hummingbot/references/getting_started.md rename to skills/hummingbot/references/getting_started.md diff --git a/assets/skills/hummingbot/references/index.md b/skills/hummingbot/references/index.md similarity index 100% rename from assets/skills/hummingbot/references/index.md rename to skills/hummingbot/references/index.md diff --git a/assets/skills/hummingbot/references/other.md b/skills/hummingbot/references/other.md similarity index 100% rename from assets/skills/hummingbot/references/other.md rename to skills/hummingbot/references/other.md diff --git a/assets/skills/hummingbot/references/strategies.md b/skills/hummingbot/references/strategies.md similarity index 100% rename from assets/skills/hummingbot/references/strategies.md rename to skills/hummingbot/references/strategies.md diff --git a/assets/skills/hummingbot/references/trading.md b/skills/hummingbot/references/trading.md similarity index 100% rename from assets/skills/hummingbot/references/trading.md rename to skills/hummingbot/references/trading.md diff --git a/assets/skills/hummingbot/references/troubleshooting.md b/skills/hummingbot/references/troubleshooting.md similarity index 100% rename from assets/skills/hummingbot/references/troubleshooting.md rename to skills/hummingbot/references/troubleshooting.md diff --git a/assets/skills/coingecko/assets/.gitkeep b/skills/hummingbot/scripts/.gitkeep similarity index 100% rename from assets/skills/coingecko/assets/.gitkeep rename to skills/hummingbot/scripts/.gitkeep diff --git a/assets/skills/markdown-to-epub/SKILL.md b/skills/markdown-to-epub/SKILL.md similarity index 93% rename from assets/skills/markdown-to-epub/SKILL.md rename to skills/markdown-to-epub/SKILL.md index 60abc23..59e711a 100644 --- a/assets/skills/markdown-to-epub/SKILL.md +++ b/skills/markdown-to-epub/SKILL.md @@ -30,7 +30,7 @@ Trigger when any of these applies: **Build a basic EPUB** ```bash -python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ +python3 skills/markdown-to-epub/scripts/build_epub.py \ --input-md "./book.md" \ --output-epub "./book.epub" \ --title "Book Title" \ @@ -40,7 +40,7 @@ python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ **Use a custom source root and build directory** ```bash -python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ +python3 skills/markdown-to-epub/scripts/build_epub.py \ --input-md "./manuscript/book.md" \ --source-root "./manuscript" \ --build-dir "./build/book-epub" \ @@ -49,7 +49,7 @@ python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ **Recover missing assets with a fallback map** ```bash -python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ +python3 skills/markdown-to-epub/scripts/build_epub.py \ --input-md "./book.md" \ --output-epub "./book.epub" \ --fallback-map "./fallback-map.json" @@ -57,7 +57,7 @@ python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ **Allow unresolved local images but report them** ```bash -python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ +python3 skills/markdown-to-epub/scripts/build_epub.py \ --input-md "./book.md" \ --output-epub "./book.epub" \ --no-strict-missing @@ -65,7 +65,7 @@ python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ **Point to a non-standard Calibre binary** ```bash -python3 assets/skills/markdown-to-epub/scripts/build_epub.py \ +python3 skills/markdown-to-epub/scripts/build_epub.py \ --input-md "./book.md" \ --ebook-convert-bin "/opt/calibre/ebook-convert" ``` diff --git a/assets/skills/markdown-to-epub/agents/openai.yaml b/skills/markdown-to-epub/agents/openai.yaml similarity index 100% rename from assets/skills/markdown-to-epub/agents/openai.yaml rename to skills/markdown-to-epub/agents/openai.yaml diff --git a/assets/skills/markdown-to-epub/references/index.md b/skills/markdown-to-epub/references/index.md similarity index 100% rename from assets/skills/markdown-to-epub/references/index.md rename to skills/markdown-to-epub/references/index.md diff --git a/assets/skills/markdown-to-epub/scripts/build_epub.py b/skills/markdown-to-epub/scripts/build_epub.py similarity index 100% rename from assets/skills/markdown-to-epub/scripts/build_epub.py rename to skills/markdown-to-epub/scripts/build_epub.py diff --git a/assets/skills/polymarket/SKILL.md b/skills/polymarket/SKILL.md similarity index 100% rename from assets/skills/polymarket/SKILL.md rename to skills/polymarket/SKILL.md diff --git a/assets/skills/coingecko/scripts/.gitkeep b/skills/polymarket/assets/.gitkeep similarity index 100% rename from assets/skills/coingecko/scripts/.gitkeep rename to skills/polymarket/assets/.gitkeep diff --git a/assets/skills/polymarket/references/README.md b/skills/polymarket/references/README.md similarity index 100% rename from assets/skills/polymarket/references/README.md rename to skills/polymarket/references/README.md diff --git a/assets/skills/polymarket/references/api.md b/skills/polymarket/references/api.md similarity index 100% rename from assets/skills/polymarket/references/api.md rename to skills/polymarket/references/api.md diff --git a/assets/skills/polymarket/references/getting_started.md b/skills/polymarket/references/getting_started.md similarity index 100% rename from assets/skills/polymarket/references/getting_started.md rename to skills/polymarket/references/getting_started.md diff --git a/assets/skills/polymarket/references/guides.md b/skills/polymarket/references/guides.md similarity index 100% rename from assets/skills/polymarket/references/guides.md rename to skills/polymarket/references/guides.md diff --git a/assets/skills/polymarket/references/index.md b/skills/polymarket/references/index.md similarity index 100% rename from assets/skills/polymarket/references/index.md rename to skills/polymarket/references/index.md diff --git a/assets/skills/polymarket/references/learn.md b/skills/polymarket/references/learn.md similarity index 100% rename from assets/skills/polymarket/references/learn.md rename to skills/polymarket/references/learn.md diff --git a/assets/skills/polymarket/references/llms-full.md b/skills/polymarket/references/llms-full.md similarity index 100% rename from assets/skills/polymarket/references/llms-full.md rename to skills/polymarket/references/llms-full.md diff --git a/assets/skills/polymarket/references/llms.md b/skills/polymarket/references/llms.md similarity index 100% rename from assets/skills/polymarket/references/llms.md rename to skills/polymarket/references/llms.md diff --git a/assets/skills/polymarket/references/other.md b/skills/polymarket/references/other.md similarity index 100% rename from assets/skills/polymarket/references/other.md rename to skills/polymarket/references/other.md diff --git a/assets/skills/polymarket/references/realtime-client.md b/skills/polymarket/references/realtime-client.md similarity index 100% rename from assets/skills/polymarket/references/realtime-client.md rename to skills/polymarket/references/realtime-client.md diff --git a/assets/skills/polymarket/references/trading.md b/skills/polymarket/references/trading.md similarity index 100% rename from assets/skills/polymarket/references/trading.md rename to skills/polymarket/references/trading.md diff --git a/assets/skills/cryptofeed/assets/.gitkeep b/skills/polymarket/scripts/.gitkeep similarity index 100% rename from assets/skills/cryptofeed/assets/.gitkeep rename to skills/polymarket/scripts/.gitkeep diff --git a/assets/skills/postgresql/SKILL.md b/skills/postgresql/SKILL.md similarity index 100% rename from assets/skills/postgresql/SKILL.md rename to skills/postgresql/SKILL.md diff --git a/assets/skills/cryptofeed/scripts/.gitkeep b/skills/postgresql/assets/.gitkeep similarity index 100% rename from assets/skills/cryptofeed/scripts/.gitkeep rename to skills/postgresql/assets/.gitkeep diff --git a/assets/skills/postgresql/references/getting_started.md b/skills/postgresql/references/getting_started.md similarity index 100% rename from assets/skills/postgresql/references/getting_started.md rename to skills/postgresql/references/getting_started.md diff --git a/assets/skills/postgresql/references/index.md b/skills/postgresql/references/index.md similarity index 100% rename from assets/skills/postgresql/references/index.md rename to skills/postgresql/references/index.md diff --git a/assets/skills/postgresql/references/sql.md b/skills/postgresql/references/sql.md similarity index 100% rename from assets/skills/postgresql/references/sql.md rename to skills/postgresql/references/sql.md diff --git a/assets/skills/hummingbot/assets/.gitkeep b/skills/postgresql/scripts/.gitkeep similarity index 100% rename from assets/skills/hummingbot/assets/.gitkeep rename to skills/postgresql/scripts/.gitkeep diff --git a/assets/skills/proxychains/SKILL.md b/skills/proxychains/SKILL.md similarity index 97% rename from assets/skills/proxychains/SKILL.md rename to skills/proxychains/SKILL.md index 2d02c19..4db1ea2 100644 --- a/assets/skills/proxychains/SKILL.md +++ b/skills/proxychains/SKILL.md @@ -35,7 +35,7 @@ sudo apt install proxychains4 **Create user config for the local proxy** ```bash mkdir -p ~/.proxychains -cp assets/skills/proxychains/references/proxychains.conf ~/.proxychains/proxychains.conf +cp skills/proxychains/references/proxychains.conf ~/.proxychains/proxychains.conf ``` **Test the proxy** diff --git a/assets/skills/hummingbot/scripts/.gitkeep b/skills/proxychains/assets/.gitkeep similarity index 100% rename from assets/skills/hummingbot/scripts/.gitkeep rename to skills/proxychains/assets/.gitkeep diff --git a/assets/skills/proxychains/references/index.md b/skills/proxychains/references/index.md similarity index 100% rename from assets/skills/proxychains/references/index.md rename to skills/proxychains/references/index.md diff --git a/assets/skills/proxychains/references/proxychains.conf b/skills/proxychains/references/proxychains.conf similarity index 100% rename from assets/skills/proxychains/references/proxychains.conf rename to skills/proxychains/references/proxychains.conf diff --git a/assets/skills/proxychains/references/quick-reference.md b/skills/proxychains/references/quick-reference.md similarity index 100% rename from assets/skills/proxychains/references/quick-reference.md rename to skills/proxychains/references/quick-reference.md diff --git a/assets/skills/proxychains/references/setup-guide.md b/skills/proxychains/references/setup-guide.md similarity index 100% rename from assets/skills/proxychains/references/setup-guide.md rename to skills/proxychains/references/setup-guide.md diff --git a/assets/skills/proxychains/references/troubleshooting.md b/skills/proxychains/references/troubleshooting.md similarity index 100% rename from assets/skills/proxychains/references/troubleshooting.md rename to skills/proxychains/references/troubleshooting.md diff --git a/assets/skills/proxychains/scripts/setup-proxy.sh b/skills/proxychains/scripts/setup-proxy.sh similarity index 100% rename from assets/skills/proxychains/scripts/setup-proxy.sh rename to skills/proxychains/scripts/setup-proxy.sh diff --git a/assets/skills/snapdom/SKILL.md b/skills/snapdom/SKILL.md similarity index 100% rename from assets/skills/snapdom/SKILL.md rename to skills/snapdom/SKILL.md diff --git a/assets/skills/polymarket/assets/.gitkeep b/skills/snapdom/assets/.gitkeep similarity index 100% rename from assets/skills/polymarket/assets/.gitkeep rename to skills/snapdom/assets/.gitkeep diff --git a/assets/skills/snapdom/references/index.md b/skills/snapdom/references/index.md similarity index 100% rename from assets/skills/snapdom/references/index.md rename to skills/snapdom/references/index.md diff --git a/assets/skills/snapdom/references/other.md b/skills/snapdom/references/other.md similarity index 100% rename from assets/skills/snapdom/references/other.md rename to skills/snapdom/references/other.md diff --git a/assets/skills/polymarket/scripts/.gitkeep b/skills/snapdom/scripts/.gitkeep similarity index 100% rename from assets/skills/polymarket/scripts/.gitkeep rename to skills/snapdom/scripts/.gitkeep diff --git a/assets/skills/sop-generator/SKILL.md b/skills/sop-generator/SKILL.md similarity index 96% rename from assets/skills/sop-generator/SKILL.md rename to skills/sop-generator/SKILL.md index de4c225..1efaf7f 100644 --- a/assets/skills/sop-generator/SKILL.md +++ b/skills/sop-generator/SKILL.md @@ -81,12 +81,12 @@ SOP 标题 / 文档编号 ### Pattern 5: 一键生成 SOP 模板（脚本） ```text -python3 assets/skills/sop-generator/scripts/generate_sop.py --title "项目上线 SOP" --doc-id "SOP-001" --version "v1.0" --output sop.md +python3 skills/sop-generator/scripts/generate_sop.py --title "项目上线 SOP" --doc-id "SOP-001" --version "v1.0" --output sop.md ``` ### Pattern 6: 生成最小可行 SOP（MVP） ```text -python3 assets/skills/sop-generator/scripts/generate_sop.py --title "巡检 SOP" --mvp --output sop-mvp.md +python3 skills/sop-generator/scripts/generate_sop.py --title "巡检 SOP" --mvp --output sop-mvp.md ``` ## 规则与约束 diff --git a/assets/skills/sop-generator/assets/record-log-template.md b/skills/sop-generator/assets/record-log-template.md similarity index 100% rename from assets/skills/sop-generator/assets/record-log-template.md rename to skills/sop-generator/assets/record-log-template.md diff --git a/assets/skills/sop-generator/assets/sop-mvp.md b/skills/sop-generator/assets/sop-mvp.md similarity index 100% rename from assets/skills/sop-generator/assets/sop-mvp.md rename to skills/sop-generator/assets/sop-mvp.md diff --git a/assets/skills/sop-generator/assets/sop-template.md b/skills/sop-generator/assets/sop-template.md similarity index 100% rename from assets/skills/sop-generator/assets/sop-template.md rename to skills/sop-generator/assets/sop-template.md diff --git a/assets/skills/sop-generator/references/examples.md b/skills/sop-generator/references/examples.md similarity index 100% rename from assets/skills/sop-generator/references/examples.md rename to skills/sop-generator/references/examples.md diff --git a/assets/skills/sop-generator/references/index.md b/skills/sop-generator/references/index.md similarity index 100% rename from assets/skills/sop-generator/references/index.md rename to skills/sop-generator/references/index.md diff --git a/assets/skills/sop-generator/references/repo-vibe-kanban.md b/skills/sop-generator/references/repo-vibe-kanban.md similarity index 100% rename from assets/skills/sop-generator/references/repo-vibe-kanban.md rename to skills/sop-generator/references/repo-vibe-kanban.md diff --git a/assets/skills/sop-generator/references/sop-foundations.md b/skills/sop-generator/references/sop-foundations.md similarity index 100% rename from assets/skills/sop-generator/references/sop-foundations.md rename to skills/sop-generator/references/sop-foundations.md diff --git a/assets/skills/sop-generator/references/sop-structure.md b/skills/sop-generator/references/sop-structure.md similarity index 100% rename from assets/skills/sop-generator/references/sop-structure.md rename to skills/sop-generator/references/sop-structure.md diff --git a/assets/skills/sop-generator/references/writing-style.md b/skills/sop-generator/references/writing-style.md similarity index 100% rename from assets/skills/sop-generator/references/writing-style.md rename to skills/sop-generator/references/writing-style.md diff --git a/assets/skills/sop-generator/scripts/generate_sop.py b/skills/sop-generator/scripts/generate_sop.py similarity index 100% rename from assets/skills/sop-generator/scripts/generate_sop.py rename to skills/sop-generator/scripts/generate_sop.py diff --git a/assets/skills/telegram-dev/SKILL.md b/skills/telegram-dev/SKILL.md similarity index 100% rename from assets/skills/telegram-dev/SKILL.md rename to skills/telegram-dev/SKILL.md diff --git a/assets/skills/postgresql/assets/.gitkeep b/skills/telegram-dev/assets/.gitkeep similarity index 100% rename from assets/skills/postgresql/assets/.gitkeep rename to skills/telegram-dev/assets/.gitkeep diff --git a/assets/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md b/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md similarity index 100% rename from assets/skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md rename to skills/telegram-dev/references/Telegram_Bot_按钮和键盘实现模板.md diff --git a/assets/skills/telegram-dev/references/index.md b/skills/telegram-dev/references/index.md similarity index 100% rename from assets/skills/telegram-dev/references/index.md rename to skills/telegram-dev/references/index.md diff --git a/assets/skills/telegram-dev/references/动态视图对齐实现文档.md b/skills/telegram-dev/references/动态视图对齐实现文档.md similarity index 100% rename from assets/skills/telegram-dev/references/动态视图对齐实现文档.md rename to skills/telegram-dev/references/动态视图对齐实现文档.md diff --git a/assets/skills/postgresql/scripts/.gitkeep b/skills/telegram-dev/scripts/.gitkeep similarity index 100% rename from assets/skills/postgresql/scripts/.gitkeep rename to skills/telegram-dev/scripts/.gitkeep diff --git a/assets/skills/timescaledb/SKILL.md b/skills/timescaledb/SKILL.md similarity index 100% rename from assets/skills/timescaledb/SKILL.md rename to skills/timescaledb/SKILL.md diff --git a/assets/skills/proxychains/assets/.gitkeep b/skills/timescaledb/assets/.gitkeep similarity index 100% rename from assets/skills/proxychains/assets/.gitkeep rename to skills/timescaledb/assets/.gitkeep diff --git a/assets/skills/timescaledb/references/CONTRIBUTING.md b/skills/timescaledb/references/CONTRIBUTING.md similarity index 63% rename from assets/skills/timescaledb/references/CONTRIBUTING.md rename to skills/timescaledb/references/CONTRIBUTING.md index 3a44a53..03bfd0a 100644 --- a/assets/skills/timescaledb/references/CONTRIBUTING.md +++ b/skills/timescaledb/references/CONTRIBUTING.md @@ -1,6 +1,6 @@ # TimescaleDB Docs Contributing（外链） -本仓库未在 `assets/skills/timescaledb/references/` 内维护完整贡献指南原文。 +本仓库未在 `skills/timescaledb/references/` 内维护完整贡献指南原文。 请参考官方贡献指南（Docs 仓库）： diff --git a/assets/skills/timescaledb/references/api.md b/skills/timescaledb/references/api.md similarity index 100% rename from assets/skills/timescaledb/references/api.md rename to skills/timescaledb/references/api.md diff --git a/assets/skills/timescaledb/references/compression.md b/skills/timescaledb/references/compression.md similarity index 100% rename from assets/skills/timescaledb/references/compression.md rename to skills/timescaledb/references/compression.md diff --git a/assets/skills/timescaledb/references/continuous_aggregates.md b/skills/timescaledb/references/continuous_aggregates.md similarity index 100% rename from assets/skills/timescaledb/references/continuous_aggregates.md rename to skills/timescaledb/references/continuous_aggregates.md diff --git a/assets/skills/timescaledb/references/getting_started.md b/skills/timescaledb/references/getting_started.md similarity index 100% rename from assets/skills/timescaledb/references/getting_started.md rename to skills/timescaledb/references/getting_started.md diff --git a/assets/skills/timescaledb/references/hyperfunctions.md b/skills/timescaledb/references/hyperfunctions.md similarity index 100% rename from assets/skills/timescaledb/references/hyperfunctions.md rename to skills/timescaledb/references/hyperfunctions.md diff --git a/assets/skills/timescaledb/references/hypertables.md b/skills/timescaledb/references/hypertables.md similarity index 100% rename from assets/skills/timescaledb/references/hypertables.md rename to skills/timescaledb/references/hypertables.md diff --git a/assets/skills/timescaledb/references/index.md b/skills/timescaledb/references/index.md similarity index 100% rename from assets/skills/timescaledb/references/index.md rename to skills/timescaledb/references/index.md diff --git a/assets/skills/timescaledb/references/installation.md b/skills/timescaledb/references/installation.md similarity index 100% rename from assets/skills/timescaledb/references/installation.md rename to skills/timescaledb/references/installation.md diff --git a/assets/skills/timescaledb/references/llms-full.md b/skills/timescaledb/references/llms-full.md similarity index 100% rename from assets/skills/timescaledb/references/llms-full.md rename to skills/timescaledb/references/llms-full.md diff --git a/assets/skills/timescaledb/references/llms.md b/skills/timescaledb/references/llms.md similarity index 100% rename from assets/skills/timescaledb/references/llms.md rename to skills/timescaledb/references/llms.md diff --git a/assets/skills/timescaledb/references/other.md b/skills/timescaledb/references/other.md similarity index 100% rename from assets/skills/timescaledb/references/other.md rename to skills/timescaledb/references/other.md diff --git a/assets/skills/timescaledb/references/performance.md b/skills/timescaledb/references/performance.md similarity index 100% rename from assets/skills/timescaledb/references/performance.md rename to skills/timescaledb/references/performance.md diff --git a/assets/skills/timescaledb/references/time_buckets.md b/skills/timescaledb/references/time_buckets.md similarity index 100% rename from assets/skills/timescaledb/references/time_buckets.md rename to skills/timescaledb/references/time_buckets.md diff --git a/assets/skills/timescaledb/references/tutorials.md b/skills/timescaledb/references/tutorials.md similarity index 100% rename from assets/skills/timescaledb/references/tutorials.md rename to skills/timescaledb/references/tutorials.md diff --git a/assets/skills/snapdom/assets/.gitkeep b/skills/timescaledb/scripts/.gitkeep similarity index 100% rename from assets/skills/snapdom/assets/.gitkeep rename to skills/timescaledb/scripts/.gitkeep diff --git a/assets/skills/tmux-autopilot/AGENTS.md b/skills/tmux-autopilot/AGENTS.md similarity index 73% rename from assets/skills/tmux-autopilot/AGENTS.md rename to skills/tmux-autopilot/AGENTS.md index 68ed9f8..58e10c9 100644 --- a/assets/skills/tmux-autopilot/AGENTS.md +++ b/skills/tmux-autopilot/AGENTS.md @@ -1,16 +1,16 @@ -# assets/skills/tmux-autopilot +# skills/tmux-autopilot 本目录是 tmux 自动化操控技能：面向 AI 终端巡检、按键注入、蜂群协作与 oh-my-tmux 配置复用。 ## 目录结构 ```text -assets/skills/tmux-autopilot/ +skills/tmux-autopilot/ ├── AGENTS.md # 本文件：目录职责、结构与边界 ├── SKILL.md # 技能入口：触发条件、命令片段、规则与质量门 ├── assets/ # 外部 tmux 相关仓库的只读软链接入口 -│ ├── oh-my-tmux -> ../../../repos/.tmux -│ └── tmux-src -> ../../../repos/tmux +│ ├── oh-my-tmux -> ../../../tools/external/.tmux +│ └── tmux-src -> ../../../tools/external/tmux └── references/ # 长文档、示例与故障排查 ├── index.md ├── getting_started.md @@ -23,11 +23,11 @@ assets/skills/tmux-autopilot/ - `assets/oh-my-tmux` 只暴露 gpakosz/oh-my-tmux submodule，不在技能目录内复制配置源码。 - `assets/tmux-src` 只暴露 tmux/tmux submodule，供需要查看源码或上游文档时定位。 -- 技能文档可以引用软链接入口；更新上游内容必须通过 `assets/repos/` 下的 submodule 指针完成。 +- 技能文档可以引用软链接入口；更新上游内容必须通过 `tools/external/` 下的 submodule 指针完成。 - 不在本目录直接修改 submodule 内容；如需改造，先 fork 上游并更新 submodule 来源。 ## 依赖关系 -- 上游来源：`assets/repos/.tmux` 与 `assets/repos/tmux`。 +- 上游来源：`tools/external/.tmux` 与 `tools/external/tmux`。 - 下游使用：`SKILL.md` 和 `references/` 中的命令示例。 -- 验证入口：`assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/tmux-autopilot --strict`。 +- 验证入口：`skills/auto-skill/scripts/validate-skill.sh skills/tmux-autopilot --strict`。 diff --git a/assets/skills/tmux-autopilot/SKILL.md b/skills/tmux-autopilot/SKILL.md similarity index 91% rename from assets/skills/tmux-autopilot/SKILL.md rename to skills/tmux-autopilot/SKILL.md index 18a2146..325bf36 100644 --- a/assets/skills/tmux-autopilot/SKILL.md +++ b/skills/tmux-autopilot/SKILL.md @@ -5,7 +5,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane， # tmux-autopilot Skill -让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `assets/repos/.tmux`（gpakosz/oh-my-tmux），并在本技能内通过 `assets/oh-my-tmux` 与 `assets/tmux-src` 暴露上游 submodule。 +让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `tools/external/.tmux`（gpakosz/oh-my-tmux），并在本技能内通过 `assets/oh-my-tmux` 与 `assets/tmux-src` 暴露上游 submodule。 ## When to Use This Skill @@ -14,7 +14,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane， - 需要向指定 pane 发送按键/命令（确认 `y`、`Enter`、`Ctrl+C`、广播同一窗口）。 - 需要批量巡检/接管多 AI 终端（蜂群协作、自动救援卡死任务）。 - 需要快速回忆 oh-my-tmux 快捷键、前缀或同步面板操作。 -- 需要在当前仓库复用 `assets/repos/.tmux` 配置并避免修改主配置。 +- 需要在当前仓库复用 `tools/external/.tmux` 配置并避免修改主配置。 - 需要从技能目录内快速查看 oh-my-tmux 配置或 tmux 上游源码入口。 ## Not For / Boundaries @@ -87,8 +87,8 @@ tmux attach -t ai-hub **启用 oh-my-tmux 配置（仓库内版本）** ```bash repo_root="$(git rev-parse --show-toplevel)" -ln -sfn "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf" ~/.tmux.conf -cp -n "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf.local" ~/.tmux.conf.local +ln -sfn "$repo_root/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf" ~/.tmux.conf +cp -n "$repo_root/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf.local" ~/.tmux.conf.local ``` **记录 pane 输出到文件** @@ -160,7 +160,7 @@ tmux pipe-pane -t :. -o 'cat >> /tmp/tmux--:. -o 'cat >> /tmp/tmux-- ../repos/claude-official-skills -assets/skills/tmux-autopilot/assets/oh-my-tmux -> ../../../repos/.tmux -assets/skills/tmux-autopilot/assets/tmux-src -> ../../../repos/tmux -assets/skills/auto-skill/scripts/Skill_Seekers-development -> ../../../repos/Skill_Seekers-development -assets/skills/auto-skill/scripts/skill-seekers-configs -> Skill_Seekers-development/configs -assets/skills/auto-skill/scripts/skill-seekers-src -> Skill_Seekers-development/src +skills/claude-official-skills -> ../tools/external/claude-official-skills +skills/tmux-autopilot/assets/oh-my-tmux -> ../../../tools/external/.tmux +skills/tmux-autopilot/assets/tmux-src -> ../../../tools/external/tmux +skills/auto-skill/scripts/Skill_Seekers-development -> ../../../tools/external/Skill_Seekers-development +skills/auto-skill/scripts/skill-seekers-configs -> Skill_Seekers-development/configs +skills/auto-skill/scripts/skill-seekers-src -> Skill_Seekers-development/src ``` ## 操作规范 @@ -38,7 +35,7 @@ assets/skills/auto-skill/scripts/skill-seekers-src -> Skill_Seekers-development/ - 新增外部依赖（优先 Git submodule，确保可复现） - 更新 submodule 指针（明确记录上游来源与用途） -- 用相对软链接把 `assets/repos/` 下的事实来源暴露到其它资产目录，软链接目标必须仍在仓库内 +- 用相对软链接把 `tools/external/` 下的事实来源暴露到其它目录，软链接目标必须仍在仓库内 - 为已复制进主仓库的外部源码建立清退计划：上游 URL、保留理由、迁移方式、验证命令 ### 禁止 / 不推荐 @@ -51,7 +48,7 @@ assets/skills/auto-skill/scripts/skill-seekers-src -> Skill_Seekers-development/ ## 仓库表达决策 1. **完整外部仓库**：优先使用 `git submodule`，主仓库只记录 commit 指针。 -2. **同仓多入口展示**：使用相对软链接，例如 `assets/skills/ -> ../repos/`。 +2. **同仓多入口展示**：使用相对软链接，例如 `skills/ -> ../tools/external/`。 3. **项目内小工具**：只有在无上游、体量小、与本项目强耦合时才直接追踪源码。 4. **生成输出**：默认不跟踪；若必须保留样例，只提交最小样例和生成说明。 -5. **历史备份**：`assets/repos/backups/` 按项目资产处理，不套用外部仓库清退规则。 +5. **历史备份**：`scripts/backups/` 按项目资产处理，不套用外部仓库清退规则。 diff --git a/assets/repos/MCPlayerTransfer/README.md b/tools/external/MCPlayerTransfer/README.md similarity index 100% rename from assets/repos/MCPlayerTransfer/README.md rename to tools/external/MCPlayerTransfer/README.md diff --git a/assets/repos/MCPlayerTransfer/docs/使用文档.md b/tools/external/MCPlayerTransfer/docs/使用文档.md similarity index 100% rename from assets/repos/MCPlayerTransfer/docs/使用文档.md rename to tools/external/MCPlayerTransfer/docs/使用文档.md diff --git a/assets/repos/MCPlayerTransfer/main.py b/tools/external/MCPlayerTransfer/main.py similarity index 100% rename from assets/repos/MCPlayerTransfer/main.py rename to tools/external/MCPlayerTransfer/main.py diff --git a/assets/repos/MCPlayerTransfer/requirements.txt b/tools/external/MCPlayerTransfer/requirements.txt similarity index 100% rename from assets/repos/MCPlayerTransfer/requirements.txt rename to tools/external/MCPlayerTransfer/requirements.txt diff --git a/assets/repos/MCPlayerTransfer/src/__init__.py b/tools/external/MCPlayerTransfer/src/__init__.py similarity index 100% rename from assets/repos/MCPlayerTransfer/src/__init__.py rename to tools/external/MCPlayerTransfer/src/__init__.py diff --git a/assets/repos/MCPlayerTransfer/src/extract_player.py b/tools/external/MCPlayerTransfer/src/extract_player.py similarity index 100% rename from assets/repos/MCPlayerTransfer/src/extract_player.py rename to tools/external/MCPlayerTransfer/src/extract_player.py diff --git a/assets/repos/MCPlayerTransfer/src/import_player.py b/tools/external/MCPlayerTransfer/src/import_player.py similarity index 100% rename from assets/repos/MCPlayerTransfer/src/import_player.py rename to tools/external/MCPlayerTransfer/src/import_player.py diff --git a/tools/external/README.md b/tools/external/README.md new file mode 100644 index 0000000..8984c32 --- /dev/null +++ b/tools/external/README.md @@ -0,0 +1,65 @@ +# 🔌 tools/external：外部仓库与第三方工具 + +`tools/external/` 用来收纳第三方工具、外部依赖与 Git submodule。核心原则是： + +- **尽量原样保留**：避免“魔改后不可升级” +- **隔离依赖与风险**：外部工具的依赖不要污染主仓库 +- **可追溯**：来源、许可证、用法要写清楚 + +## 目录结构 + +```text +tools/external/ +├── AGENTS.md # 本目录的 Agent 行为准则 +├── README.md # 本文件（外部工具索引） +├── .tmux/ # submodule：oh-my-tmux 配置 +├── tmux/ # submodule：tmux 源码 +├── claude-official-skills/ # submodule：Claude 官方 skills 仓库 +├── Skill_Seekers-development/ # submodule：Skills 制作器 +├── html-tools-main/ # HTML 工具集 +├── my-nvim/ # Neovim 配置 +├── MCPlayerTransfer/ # MC 玩家迁移工具 +└── XHS-image-to-PDF-conversion/ # 图片合并 PDF 工具 +``` + +## 工具清单 + +- `Skill_Seekers-development/`：以 submodule 引入的 Skills 抓取/制作器 +- `.tmux/`：以 submodule 引入的 oh-my-tmux 配置来源 +- `tmux/`：以 submodule 引入的 tmux 上游源码 +- `claude-official-skills/`：以 submodule 引入的 Claude 官方 skills 仓库 +- `html-tools-main/`：HTML 工具集 +- `my-nvim/`：个人 Neovim 配置 +- `MCPlayerTransfer/`：MC 玩家迁移工具 +- `XHS-image-to-PDF-conversion/`：图片合并 PDF 工具 + +## 相关迁移 + +- 提示词转换工具已迁移到 `tools/prompts-library/`。 +- AI 聊天记录保存工具已迁移到 `tools/chat-vault/`。 +- 备份脚本已迁移到 `scripts/backups/`。 +- 技能库入口已迁移到 `skills/`。 + +## 当前软链接显示 + +| 事实来源 | 展示入口 | 说明 | +|:---|:---|:---| +| `tools/external/.tmux/` | `skills/tmux-autopilot/assets/oh-my-tmux` | oh-my-tmux 配置来源 | +| `tools/external/tmux/` | `skills/tmux-autopilot/assets/tmux-src` | tmux 上游源码入口 | +| `tools/external/claude-official-skills/` | `skills/claude-official-skills` | Claude 官方 skills 仓库 | +| `tools/external/Skill_Seekers-development/` | `skills/auto-skill/scripts/Skill_Seekers-development` | `auto-skill` 的 Skill Seekers 工具来源 | + +## 表达规则 + +- 完整外部仓库：优先 `git submodule add tools/external/`。 +- 跨目录展示入口：使用相对软链接，例如 `skills/ -> ../tools/external/`。 +- 不允许：软链接到本机绝对路径、复制大型上游源码、提交构建产物/生成物、提交二进制运行时。 +- 需要本地改造第三方工具时：优先 fork 后以 submodule 指向 fork；不要在主仓库直接魔改一份不可升级的源码快照。 + +## 新增外部工具（最小清单） + +1. 优先新增 submodule：`git submodule add tools/external/`。 +2. 只在没有上游仓库、且体量小/与本项目强耦合时，才创建普通目录：`tools/external//`。 +3. 必备文件：`README.md`（用途/入口/依赖/输入输出）、许可证与来源说明（如 `LICENSE` / `SOURCE.md`）。 +4. 依赖约束：尽量使用工具自带的虚拟环境/容器化方式，不影响仓库其他部分。 +5. 文档同步：在本 README 增加一行工具说明，保证可发现性。 diff --git a/assets/repos/Skill_Seekers-development b/tools/external/Skill_Seekers-development similarity index 100% rename from assets/repos/Skill_Seekers-development rename to tools/external/Skill_Seekers-development diff --git a/assets/repos/XHS-image-to-PDF-conversion/CONTRIBUTING.md b/tools/external/XHS-image-to-PDF-conversion/CONTRIBUTING.md similarity index 100% rename from assets/repos/XHS-image-to-PDF-conversion/CONTRIBUTING.md rename to tools/external/XHS-image-to-PDF-conversion/CONTRIBUTING.md diff --git a/assets/repos/XHS-image-to-PDF-conversion/README.md b/tools/external/XHS-image-to-PDF-conversion/README.md similarity index 100% rename from assets/repos/XHS-image-to-PDF-conversion/README.md rename to tools/external/XHS-image-to-PDF-conversion/README.md diff --git a/assets/repos/XHS-image-to-PDF-conversion/pdf.bat b/tools/external/XHS-image-to-PDF-conversion/pdf.bat similarity index 100% rename from assets/repos/XHS-image-to-PDF-conversion/pdf.bat rename to tools/external/XHS-image-to-PDF-conversion/pdf.bat diff --git a/assets/repos/XHS-image-to-PDF-conversion/pdf.py b/tools/external/XHS-image-to-PDF-conversion/pdf.py similarity index 100% rename from assets/repos/XHS-image-to-PDF-conversion/pdf.py rename to tools/external/XHS-image-to-PDF-conversion/pdf.py diff --git a/assets/repos/XHS-image-to-PDF-conversion/requirements.txt b/tools/external/XHS-image-to-PDF-conversion/requirements.txt similarity index 100% rename from assets/repos/XHS-image-to-PDF-conversion/requirements.txt rename to tools/external/XHS-image-to-PDF-conversion/requirements.txt diff --git a/assets/repos/claude-official-skills b/tools/external/claude-official-skills similarity index 100% rename from assets/repos/claude-official-skills rename to tools/external/claude-official-skills diff --git a/assets/repos/html-tools-main/README.md b/tools/external/html-tools-main/README.md similarity index 100% rename from assets/repos/html-tools-main/README.md rename to tools/external/html-tools-main/README.md diff --git a/assets/repos/html-tools-main/clean_epub_css.html b/tools/external/html-tools-main/clean_epub_css.html similarity index 100% rename from assets/repos/html-tools-main/clean_epub_css.html rename to tools/external/html-tools-main/clean_epub_css.html diff --git a/assets/repos/html-tools-main/markdown-bianjiqi.html b/tools/external/html-tools-main/markdown-bianjiqi.html similarity index 100% rename from assets/repos/html-tools-main/markdown-bianjiqi.html rename to tools/external/html-tools-main/markdown-bianjiqi.html diff --git a/assets/repos/html-tools-main/task card generator.html b/tools/external/html-tools-main/task card generator.html similarity index 100% rename from assets/repos/html-tools-main/task card generator.html rename to tools/external/html-tools-main/task card generator.html diff --git a/assets/repos/html-tools-main/xhs graphic production - 1.0.html b/tools/external/html-tools-main/xhs graphic production - 1.0.html similarity index 100% rename from assets/repos/html-tools-main/xhs graphic production - 1.0.html rename to tools/external/html-tools-main/xhs graphic production - 1.0.html diff --git a/assets/repos/html-tools-main/xhs graphic production.html b/tools/external/html-tools-main/xhs graphic production.html similarity index 100% rename from assets/repos/html-tools-main/xhs graphic production.html rename to tools/external/html-tools-main/xhs graphic production.html diff --git a/assets/repos/my-nvim/README.md b/tools/external/my-nvim/README.md similarity index 100% rename from assets/repos/my-nvim/README.md rename to tools/external/my-nvim/README.md diff --git a/assets/repos/my-nvim/nvim-config/AGENTS.md b/tools/external/my-nvim/nvim-config/AGENTS.md similarity index 100% rename from assets/repos/my-nvim/nvim-config/AGENTS.md rename to tools/external/my-nvim/nvim-config/AGENTS.md diff --git a/assets/repos/my-nvim/nvim-config/LICENSE b/tools/external/my-nvim/nvim-config/LICENSE similarity index 100% rename from assets/repos/my-nvim/nvim-config/LICENSE rename to tools/external/my-nvim/nvim-config/LICENSE diff --git a/assets/repos/my-nvim/nvim-config/README.md b/tools/external/my-nvim/nvim-config/README.md similarity index 100% rename from assets/repos/my-nvim/nvim-config/README.md rename to tools/external/my-nvim/nvim-config/README.md diff --git a/assets/repos/my-nvim/nvim-config/init.lua b/tools/external/my-nvim/nvim-config/init.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/init.lua rename to tools/external/my-nvim/nvim-config/init.lua diff --git a/assets/repos/my-nvim/nvim-config/lazy-lock.json b/tools/external/my-nvim/nvim-config/lazy-lock.json similarity index 100% rename from assets/repos/my-nvim/nvim-config/lazy-lock.json rename to tools/external/my-nvim/nvim-config/lazy-lock.json diff --git a/assets/repos/my-nvim/nvim-config/lazyvim.json b/tools/external/my-nvim/nvim-config/lazyvim.json similarity index 100% rename from assets/repos/my-nvim/nvim-config/lazyvim.json rename to tools/external/my-nvim/nvim-config/lazyvim.json diff --git a/assets/repos/my-nvim/nvim-config/lua/config/autocmds.lua b/tools/external/my-nvim/nvim-config/lua/config/autocmds.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/config/autocmds.lua rename to tools/external/my-nvim/nvim-config/lua/config/autocmds.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/config/keymaps.lua b/tools/external/my-nvim/nvim-config/lua/config/keymaps.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/config/keymaps.lua rename to tools/external/my-nvim/nvim-config/lua/config/keymaps.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/config/lazy.lua b/tools/external/my-nvim/nvim-config/lua/config/lazy.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/config/lazy.lua rename to tools/external/my-nvim/nvim-config/lua/config/lazy.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/config/options.lua b/tools/external/my-nvim/nvim-config/lua/config/options.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/config/options.lua rename to tools/external/my-nvim/nvim-config/lua/config/options.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/plugins/colorscheme.lua b/tools/external/my-nvim/nvim-config/lua/plugins/colorscheme.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/plugins/colorscheme.lua rename to tools/external/my-nvim/nvim-config/lua/plugins/colorscheme.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/plugins/dracula.lua b/tools/external/my-nvim/nvim-config/lua/plugins/dracula.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/plugins/dracula.lua rename to tools/external/my-nvim/nvim-config/lua/plugins/dracula.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/plugins/example.lua b/tools/external/my-nvim/nvim-config/lua/plugins/example.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/plugins/example.lua rename to tools/external/my-nvim/nvim-config/lua/plugins/example.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/plugins/snacks.lua b/tools/external/my-nvim/nvim-config/lua/plugins/snacks.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/plugins/snacks.lua rename to tools/external/my-nvim/nvim-config/lua/plugins/snacks.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/plugins/ui.lua b/tools/external/my-nvim/nvim-config/lua/plugins/ui.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/plugins/ui.lua rename to tools/external/my-nvim/nvim-config/lua/plugins/ui.lua diff --git a/assets/repos/my-nvim/nvim-config/lua/themes/dracula.lua b/tools/external/my-nvim/nvim-config/lua/themes/dracula.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/lua/themes/dracula.lua rename to tools/external/my-nvim/nvim-config/lua/themes/dracula.lua diff --git a/assets/repos/my-nvim/nvim-config/nvim b/tools/external/my-nvim/nvim-config/nvim similarity index 100% rename from assets/repos/my-nvim/nvim-config/nvim rename to tools/external/my-nvim/nvim-config/nvim diff --git a/assets/repos/my-nvim/nvim-config/stylua.toml b/tools/external/my-nvim/nvim-config/stylua.toml similarity index 100% rename from assets/repos/my-nvim/nvim-config/stylua.toml rename to tools/external/my-nvim/nvim-config/stylua.toml diff --git a/assets/repos/my-nvim/nvim-config/theme-previewer.lua b/tools/external/my-nvim/nvim-config/theme-previewer.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/theme-previewer.lua rename to tools/external/my-nvim/nvim-config/theme-previewer.lua diff --git a/assets/repos/my-nvim/nvim-config/theme-switcher.lua b/tools/external/my-nvim/nvim-config/theme-switcher.lua similarity index 100% rename from assets/repos/my-nvim/nvim-config/theme-switcher.lua rename to tools/external/my-nvim/nvim-config/theme-switcher.lua diff --git a/assets/repos/tmux b/tools/external/tmux similarity index 100% rename from assets/repos/tmux rename to tools/external/tmux diff --git a/assets/repos/prompts-library/.gitignore b/tools/prompts-library/.gitignore similarity index 100% rename from assets/repos/prompts-library/.gitignore rename to tools/prompts-library/.gitignore diff --git a/assets/repos/prompts-library/README.md b/tools/prompts-library/README.md similarity index 100% rename from assets/repos/prompts-library/README.md rename to tools/prompts-library/README.md diff --git a/assets/repos/prompts-library/docs/JSONL_CONVERTER_SYSTEM_PROMPT.md b/tools/prompts-library/docs/JSONL_CONVERTER_SYSTEM_PROMPT.md similarity index 100% rename from assets/repos/prompts-library/docs/JSONL_CONVERTER_SYSTEM_PROMPT.md rename to tools/prompts-library/docs/JSONL_CONVERTER_SYSTEM_PROMPT.md diff --git a/assets/repos/prompts-library/docs/excel-data.md b/tools/prompts-library/docs/excel-data.md similarity index 100% rename from assets/repos/prompts-library/docs/excel-data.md rename to tools/prompts-library/docs/excel-data.md diff --git a/assets/repos/prompts-library/docs/support.md b/tools/prompts-library/docs/support.md similarity index 100% rename from assets/repos/prompts-library/docs/support.md rename to tools/prompts-library/docs/support.md diff --git a/assets/repos/prompts-library/docs/tools.md b/tools/prompts-library/docs/tools.md similarity index 100% rename from assets/repos/prompts-library/docs/tools.md rename to tools/prompts-library/docs/tools.md diff --git a/assets/repos/prompts-library/docs/开发文档.md b/tools/prompts-library/docs/开发文档.md similarity index 100% rename from assets/repos/prompts-library/docs/开发文档.md rename to tools/prompts-library/docs/开发文档.md diff --git a/assets/repos/prompts-library/docs/提示词库结构与 Excel 互转规范.md b/tools/prompts-library/docs/提示词库结构与 Excel 互转规范.md similarity index 100% rename from assets/repos/prompts-library/docs/提示词库结构与 Excel 互转规范.md rename to tools/prompts-library/docs/提示词库结构与 Excel 互转规范.md diff --git a/assets/repos/prompts-library/main.py b/tools/prompts-library/main.py similarity index 100% rename from assets/repos/prompts-library/main.py rename to tools/prompts-library/main.py diff --git a/assets/repos/prompts-library/requirements.txt b/tools/prompts-library/requirements.txt similarity index 100% rename from assets/repos/prompts-library/requirements.txt rename to tools/prompts-library/requirements.txt diff --git a/assets/repos/prompts-library/scripts/analyze_md_syntax.py b/tools/prompts-library/scripts/analyze_md_syntax.py similarity index 100% rename from assets/repos/prompts-library/scripts/analyze_md_syntax.py rename to tools/prompts-library/scripts/analyze_md_syntax.py diff --git a/assets/repos/prompts-library/scripts/config.yaml b/tools/prompts-library/scripts/config.yaml similarity index 100% rename from assets/repos/prompts-library/scripts/config.yaml rename to tools/prompts-library/scripts/config.yaml diff --git a/assets/repos/prompts-library/scripts/convert_local.py b/tools/prompts-library/scripts/convert_local.py similarity index 100% rename from assets/repos/prompts-library/scripts/convert_local.py rename to tools/prompts-library/scripts/convert_local.py diff --git a/assets/repos/prompts-library/scripts/docs_to_excel.py b/tools/prompts-library/scripts/docs_to_excel.py similarity index 100% rename from assets/repos/prompts-library/scripts/docs_to_excel.py rename to tools/prompts-library/scripts/docs_to_excel.py diff --git a/assets/repos/prompts-library/scripts/excel_to_docs.py b/tools/prompts-library/scripts/excel_to_docs.py similarity index 100% rename from assets/repos/prompts-library/scripts/excel_to_docs.py rename to tools/prompts-library/scripts/excel_to_docs.py diff --git a/assets/repos/prompts-library/scripts/filter_versions.py b/tools/prompts-library/scripts/filter_versions.py similarity index 100% rename from assets/repos/prompts-library/scripts/filter_versions.py rename to tools/prompts-library/scripts/filter_versions.py diff --git a/assets/repos/prompts-library/scripts/gemini_jsonl_batch.py b/tools/prompts-library/scripts/gemini_jsonl_batch.py similarity index 100% rename from assets/repos/prompts-library/scripts/gemini_jsonl_batch.py rename to tools/prompts-library/scripts/gemini_jsonl_batch.py diff --git a/assets/repos/prompts-library/scripts/jsonl_to_excel.py b/tools/prompts-library/scripts/jsonl_to_excel.py similarity index 100% rename from assets/repos/prompts-library/scripts/jsonl_to_excel.py rename to tools/prompts-library/scripts/jsonl_to_excel.py diff --git a/assets/repos/prompts-library/scripts/md_to_jsonl.py b/tools/prompts-library/scripts/md_to_jsonl.py similarity index 100% rename from assets/repos/prompts-library/scripts/md_to_jsonl.py rename to tools/prompts-library/scripts/md_to_jsonl.py diff --git a/assets/repos/prompts-library/scripts/refactor_jsonl.py b/tools/prompts-library/scripts/refactor_jsonl.py similarity index 100% rename from assets/repos/prompts-library/scripts/refactor_jsonl.py rename to tools/prompts-library/scripts/refactor_jsonl.py diff --git a/assets/repos/prompts-library/scripts/reindex_rows.py b/tools/prompts-library/scripts/reindex_rows.py similarity index 100% rename from assets/repos/prompts-library/scripts/reindex_rows.py rename to tools/prompts-library/scripts/reindex_rows.py diff --git a/assets/repos/prompts-library/scripts/requirements.txt b/tools/prompts-library/scripts/requirements.txt similarity index 100% rename from assets/repos/prompts-library/scripts/requirements.txt rename to tools/prompts-library/scripts/requirements.txt diff --git a/assets/repos/prompts-library/scripts/start_convert.py b/tools/prompts-library/scripts/start_convert.py similarity index 100% rename from assets/repos/prompts-library/scripts/start_convert.py rename to tools/prompts-library/scripts/start_convert.py diff --git a/assets/repos/prompts-library/scripts/verify_integrity.py b/tools/prompts-library/scripts/verify_integrity.py similarity index 100% rename from assets/repos/prompts-library/scripts/verify_integrity.py rename to tools/prompts-library/scripts/verify_integrity.py