chore: move workflow/repo/documents/config under assets

This commit is contained in:
tukuaiai 2026-02-27 01:46:51 +08:00
parent 4207c8fbb8
commit dffbb976e7
488 changed files with 203 additions and 196 deletions

6
.gitmodules vendored
View File

@ -1,9 +1,9 @@
[submodule "repo/.tmux"]
path = repo/.tmux
path = assets/repo/.tmux
url = https://github.com/gpakosz/.tmux.git
[submodule "repo/tmux"]
path = repo/tmux
path = assets/repo/tmux
url = https://github.com/tmux/tmux.git
[submodule "repo/claude-official-skills"]
path = repo/claude-official-skills
path = assets/repo/claude-official-skills
url = https://github.com/anthropics/skills.git

102
AGENTS.md
View File

@ -8,21 +8,21 @@
### 允许的操作
- 读取、修改顶层文档:`README.md`、`AGENTS.md`、`CONTRIBUTING.md` 等
- 读取、修改 `documents/`、`prompts/`、`skills/`、`workflow/`、`config/`、`tools/`、`repo/` 下的文档与代码
- 读取、修改 `assets/documents/`、`prompts/`、`skills/`、`assets/workflow/`、`assets/config/`、`tools/`、`assets/repo/` 下的文档与代码
- 执行 `make lint`、备份脚本、prompts-library 转换工具
- 新增/修改提示词、技能、文档
- 提交符合规范的 commit
### 禁止的操作
- 修改 `.github/workflows/` 中的 CI 配置(除非任务明确要求)
- 删除或覆盖 `repo/backups/gz/` 中的存档文件
- 删除或覆盖 `assets/repo/backups/gz/` 中的存档文件
- 修改 `LICENSE`、`CODE_OF_CONDUCT.md`
- 在代码中硬编码密钥、Token 或敏感凭证
- 未经确认的大范围重构
### 敏感区域(禁止自动修改)
- `.github/workflows/*.yml` - CI/CD 配置
- `repo/backups/gz/` - 历史备份存档
- `assets/repo/backups/gz/` - 历史备份存档
- `.env*` 文件(如存在)
---
@ -63,9 +63,9 @@ git push origin develop
|:---|:---|:---|
| `make help` | 列出所有 Make 目标 | 无 |
| `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
| `bash repo/backups/一键备份.sh` | 创建完整项目备份 | 无 |
| `python3 repo/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
| `cd repo/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
| `bash assets/repo/backups/一键备份.sh` | 创建完整项目备份 | 无 |
| `python3 assets/repo/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
| `cd assets/repo/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
### prompts-library 支持的转换模式
1. Excel → Docs将 Excel 工作簿转换为 Markdown 文档目录
@ -80,20 +80,20 @@ git push origin develop
### 架构原则
- 保持根目录扁平,避免巨石文件
- 三层内容架构:`documents/` (知识) → `prompts/` (指令) → `skills/` (能力)
- 三层内容架构:`assets/documents/` (知识) → `prompts/` (指令) → `skills/` (能力)
### 模块边界
- `documents/` - 中文知识库(方法论/入门/实战/资源)
- `assets/documents/` - 中文知识库(方法论/入门/实战/资源)
- `prompts/` - 提示词入口与云端索引
- `skills/` - 可复用技能库(每个子目录一个 Skill
- `workflow/` - 可复用工作流模板(自动开发闭环等)
- `config/` - 工具与开发配置(例如 Codex CLI
- `assets/workflow/` - 可复用工作流模板(自动开发闭环等)
- `assets/config/` - 工具与开发配置(例如 Codex CLI
- `tools/` - 预留:自定义脚本/小工具(保持可替换、可审计)
- `repo/` - 外部工具与依赖(含 Git submodule
- `assets/repo/` - 外部工具与依赖(含 Git submodule
### 依赖添加规则
- 新增工具或库时记录安装方式、最小版本与来源
- 外部依赖来源记录在 `repo/` 目录下
- 外部依赖来源记录在 `assets/repo/` 目录下
- 引入第三方脚本需标明许可证与来源
### 禁止行为
@ -138,12 +138,34 @@ git push origin develop
├── assets/ # 外部资源(指向在线表格)
│ ├── README.md # 远程表格索引(唯一真相源)
│ └── AGENTS.md # assets/ 目录规则
├── config/ # 工具与开发配置
│ └── .codex/ # Codex CLI 配置(项目级)
│ ├── config.toml # Codex CLI 配置文件
│ └── AGENTS.md # Codex/Agent 指南(本目录)
│ ├── AGENTS.md # assets/ 目录规则
│ ├── config/ # 工具与开发配置
│ │ └── .codex/ # Codex CLI 配置(项目级)
│ │ ├── config.toml # Codex CLI 配置文件
│ │ └── AGENTS.md # Codex/Agent 指南(本目录)
│ ├── documents/ # 文档库
│ │ ├── 05-哲学与方法论/ # 最高思想纲领与方法论
│ │ ├── 00-基础指南/ # 核心原则与底层逻辑
│ │ ├── 01-入门指南/ # 从零开始教程
│ │ ├── 02-方法论/ # 具体工具与技巧
│ │ └── 03-实战/ # 项目实战案例
│ ├── workflow/ # 工作流模板
│ │ ├── auto-dev-loop/ # 自动开发循环
│ │ └── canvas-dev/ # Canvas白板驱动开发
│ └── repo/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── AGENTS.md # assets/repo/ 目录规则
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── .github/ # GitHub 配置
│ ├── workflows/ # CI/CD 工作流
@ -156,13 +178,6 @@ git push origin develop
│ ├── FUNDING.yml # 赞助配置
│ └── wiki/ # GitHub Wiki 内容
├── documents/ # 文档库
│ ├── 05-哲学与方法论/ # 最高思想纲领与方法论
│ ├── 00-基础指南/ # 核心原则与底层逻辑
│ ├── 01-入门指南/ # 从零开始教程
│ ├── 02-方法论/ # 具体工具与技巧
│ ├── 03-实战/ # 项目实战案例
├── prompts/ # 提示词库(指向云端表格)
│ └── README.md # 在线表格链接
@ -177,25 +192,6 @@ git push origin develop
│ ├── tmux-autopilot/ # tmux 自动化
│ └── ... # 更多技能
├── workflow/ # 工作流模板
│ ├── auto-dev-loop/ # 自动开发循环
│ └── canvas-dev/ # Canvas白板驱动开发
├── repo/ # 可执行代码与外部依赖镜像
│ ├── README.md # 外部工具索引
│ ├── AGENTS.md # repo/ 目录规则
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── tools/ # 工具目录(预留)
│ └── .gitkeep # 保持空目录被 Git 追踪
```
@ -203,8 +199,8 @@ git push origin develop
### 关键入口文件
- `README.md` - 项目主文档,面向人类开发者
- `AGENTS.md` - AI Agent 操作手册(本文件)
- `repo/prompts-library/main.py` - 提示词转换工具入口
- `repo/backups/一键备份.sh` - 备份脚本入口
- `assets/repo/prompts-library/main.py` - 提示词转换工具入口
- `assets/repo/backups/一键备份.sh` - 备份脚本入口
- `skills/tmux-autopilot/` - tmux 自动化操控技能(基于 oh-my-tmux含 capture-pane/send-keys/蜂群巡检脚本)
- `skills/sop-generator/` - SOP 生成与规范化技能(输入资料/需求 -> 标准 SOP
@ -218,7 +214,7 @@ git push origin develop
| prompts-library 报错 | 缺少 Python 依赖 | `pip install pandas openpyxl PyYAML rich InquirerPy` |
| CI markdown-lint 失败 | `.github/lint_config.json` 缺失 | TODO新增 `.github/lint_config.json` 或调整 `.github/workflows/ci.yml` 的 lint 命令(需任务明确授权) |
| CI link-checker 失败 | 文档中存在失效链接 | 检查并修复 Markdown 中的链接 |
| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x repo/backups/一键备份.sh` |
| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x assets/repo/backups/一键备份.sh` |
---
@ -277,13 +273,13 @@ feat|fix|docs|chore|refactor|test: scope - summary
```bash
# 提示词库转换
cd repo/prompts-library && python3 main.py
cd assets/repo/prompts-library && python3 main.py
# Lint 所有 Markdown 文件
make lint
# 创建完整项目备份
bash repo/backups/一键备份.sh
bash assets/repo/backups/一键备份.sh
```
## Architecture & Structure
@ -291,11 +287,11 @@ bash repo/backups/一键备份.sh
### Core Directories
- **`prompts/`**: 提示词库(指向云端表格)
- **`skills/`**: 扁平化技能库(详见 skills/README.md
- **`documents/`**: 知识库05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战)
- **`assets/documents/`**: 知识库05-哲学与方法论、00-基础指南、01-入门指南、02-方法论、03-实战)
- **`assets/`**: 外部资源(在线表格)入口与使用说明
- **`repo/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`repo/chat-vault/`**: AI 聊天记录保存工具
- **`repo/backups/`**: 备份脚本与存档
- **`assets/repo/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`assets/repo/chat-vault/`**: AI 聊天记录保存工具
- **`assets/repo/backups/`**: 备份脚本与存档
### Key Technical Details
1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类

148
README.md
View File

@ -31,25 +31,25 @@
<!-- 资源直达 - 按重要性分组 -->
<!-- 🔴 核心理念 (红色系) -->
<p>
<a href="./documents/05-哲学与方法论/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
<a href="./documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md"><img src="https://img.shields.io/badge/🧠_核心哲学-必读-crimson?style=for-the-badge" alt="核心哲学"></a>
<a href="./documents/00-基础指南/胶水编程.md"><img src="https://img.shields.io/badge/🧬_胶水编程-银弹-red?style=for-the-badge" alt="胶水编程"></a>
<a href="./documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md"><img src="https://img.shields.io/badge/🎨_Canvas白板-图形驱动-orange?style=for-the-badge" alt="Canvas白板驱动开发"></a>
<a href="./documents/01-入门指南/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
<a href="./documents/00-基础指南/血的教训.md"><img src="https://img.shields.io/badge/🩸_血的教训-必看-red?style=for-the-badge" alt="血的教训"></a>
<a href="./documents/00-基础指南/语言层要素.md"><img src="https://img.shields.io/badge/📊_语言层要素-12层框架-gold?style=for-the-badge" alt="语言层要素"></a>
<a href="./documents/00-基础指南/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
<a href="./documents/00-基础指南/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_硬约束-铁律-darkred?style=for-the-badge" alt="强前置条件约束"></a>
<a href="./assets/documents/05-哲学与方法论/README.md"><img src="https://img.shields.io/badge/🔮_哲学方法论-底层协议-purple?style=for-the-badge" alt="哲学与方法论"></a>
<a href="./assets/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md"><img src="https://img.shields.io/badge/🧠_核心哲学-必读-crimson?style=for-the-badge" alt="核心哲学"></a>
<a href="./assets/documents/00-基础指南/胶水编程.md"><img src="https://img.shields.io/badge/🧬_胶水编程-银弹-red?style=for-the-badge" alt="胶水编程"></a>
<a href="./assets/documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md"><img src="https://img.shields.io/badge/🎨_Canvas白板-图形驱动-orange?style=for-the-badge" alt="Canvas白板驱动开发"></a>
<a href="./assets/documents/01-入门指南/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
<a href="./assets/documents/00-基础指南/血的教训.md"><img src="https://img.shields.io/badge/🩸_血的教训-必看-red?style=for-the-badge" alt="血的教训"></a>
<a href="./assets/documents/00-基础指南/语言层要素.md"><img src="https://img.shields.io/badge/📊_语言层要素-12层框架-gold?style=for-the-badge" alt="语言层要素"></a>
<a href="./assets/documents/00-基础指南/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
<a href="./assets/documents/00-基础指南/强前置条件约束.md"><img src="https://img.shields.io/badge/🚫_硬约束-铁律-darkred?style=for-the-badge" alt="强前置条件约束"></a>
<a href="./assets/README.md"><img src="https://img.shields.io/badge/📡_信息源-聚合-teal?style=for-the-badge" alt="信息源聚合"></a>
<a href="./documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md"><img src="https://img.shields.io/badge/📐_元方法论-递归优化-darkorange?style=for-the-badge" alt="元方法论"></a>
<a href="./documents/00-基础指南/编程之道.md"><img src="https://img.shields.io/badge/🧭_编程之道-道法术-orange?style=for-the-badge" alt="编程之道"></a>
<a href="./documents/03-实战/README.md"><img src="https://img.shields.io/badge/🎬_实战案例-项目实操-orange?style=for-the-badge" alt="实战案例"></a>
<a href="./assets/documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md"><img src="https://img.shields.io/badge/📐_元方法论-递归优化-darkorange?style=for-the-badge" alt="元方法论"></a>
<a href="./assets/documents/00-基础指南/编程之道.md"><img src="https://img.shields.io/badge/🧭_编程之道-道法术-orange?style=for-the-badge" alt="编程之道"></a>
<a href="./assets/documents/03-实战/README.md"><img src="https://img.shields.io/badge/🎬_实战案例-项目实操-orange?style=for-the-badge" alt="实战案例"></a>
<a href="./assets/README.md"><img src="https://img.shields.io/badge/🛠_工具集-速查-teal?style=for-the-badge" alt="工具集"></a>
<a href="./prompts/"><img src="https://img.shields.io/badge/💬_提示词-精选-purple?style=for-the-badge" alt="提示词精选"></a>
<a href="./skills/"><img src="https://img.shields.io/badge/⚡_Skills-技能大全-forestgreen?style=for-the-badge" alt="skills技能大全"></a>
<a href="https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203"><img src="https://img.shields.io/badge/📋_提示词-在线表格-blue?style=for-the-badge" alt="提示词在线表格"></a>
<a href="https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools"><img src="https://img.shields.io/badge/🔧_系统提示词-仓库-slateblue?style=for-the-badge" alt="系统提示词仓库"></a>
<a href="./repo/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
<a href="./assets/repo/chat-vault/README.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-AI会话库-gold?style=for-the-badge" alt="Chat Vault"></a>
</p>
[📋 工具与资源](#tools)
@ -109,11 +109,11 @@
完全新手?按顺序完成以下步骤:
0. [00-Vibe Coding 哲学原理](./documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
1. [01-网络环境配置](./documents/01-入门指南/01-网络环境配置.md) - 配置网络访问
2. [02-开发环境搭建](./documents/01-入门指南/02-开发环境搭建.md) - 复制提示词给 AI让 AI 指导你搭建环境
3. [03-IDE配置](./documents/01-入门指南/03-IDE配置.md) - 配置 VS Code 编辑器
4. [04-OpenCode-CLI配置](./documents/01-入门指南/04-OpenCode-CLI配置.md) - 免费 AI CLI 工具,支持 GLM-4.7/MiniMax M2.1 等模型
0. [00-Vibe Coding 哲学原理](./assets/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
1. [01-网络环境配置](./assets/documents/01-入门指南/01-网络环境配置.md) - 配置网络访问
2. [02-开发环境搭建](./assets/documents/01-入门指南/02-开发环境搭建.md) - 复制提示词给 AI让 AI 指导你搭建环境
3. [03-IDE配置](./assets/documents/01-入门指南/03-IDE配置.md) - 配置 VS Code 编辑器
4. [04-OpenCode-CLI配置](./assets/documents/01-入门指南/04-OpenCode-CLI配置.md) - 免费 AI CLI 工具,支持 GLM-4.7/MiniMax M2.1 等模型
</details>
@ -136,7 +136,7 @@
> 一句话:用“生成器/优化器”的递归闭环,构建一个能持续自我优化的 AI 系统。
>
> 延伸阅读:[A Formalization of Recursive Self-Optimizing Generative Systems](./documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
> 延伸阅读:[A Formalization of Recursive Self-Optimizing Generative Systems](./assets/documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
### 核心角色
- **α-提示词(生成器)**:一个“母体”提示词,其唯一职责是生成其他提示词或技能。
@ -166,7 +166,7 @@
| 🧩 复杂性爆炸 | ✅ 每个模块都是久经考验的轮子 |
| 🎓 门槛过高 | ✅ 你只需要描述"连接方式" |
👉 [深入了解胶水编程](./documents/00-基础指南/胶水编程.md)
👉 [深入了解胶水编程](./assets/documents/00-基础指南/胶水编程.md)
</details>
@ -187,7 +187,7 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
**核心理念**:图形是第一公民,代码是白板的序列化形式。
👉 [深入了解Canvas白板驱动开发](./documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md)
👉 [深入了解Canvas白板驱动开发](./assets/documents/02-方法论/图形化AI协作-Canvas白板驱动开发.md)
</details>
@ -208,7 +208,7 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
**核心突破**AI 不再是孤立的,而是可以互相感知、通讯、控制的集群。
👉 [深入了解AI蜂群协作](./documents/02-方法论/AI蜂群协作-tmux多Agent协作系统.md)
👉 [深入了解AI蜂群协作](./assets/documents/02-方法论/AI蜂群协作-tmux多Agent协作系统.md)
</details>
@ -229,7 +229,7 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
**核心理念**:哲学不是空谈,是可落地的工程方法。
👉 [深入了解哲学方法论工具箱](./documents/05-哲学与方法论/README.md)
👉 [深入了解哲学方法论工具箱](./assets/documents/05-哲学与方法论/README.md)
</details>
@ -310,12 +310,12 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
* [**第三方系统提示词学习库**](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): 用于生成提示词的高级提示词。
* [**通用项目架构模板**](./documents/00-基础指南/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
* [**通用项目架构模板**](./assets/documents/00-基础指南/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
* [**元技能Skills 的 Skills**](./skills/skills-skills/SKILL.md): 用于生成 Skills 的元技能。
* [**SOP 生成 Skill**](./skills/sop-generator/SKILL.md): 将资料/需求整理为可执行 SOP 的技能。
* [**tmux快捷键大全**](./documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。
* [**LazyVim快捷键大全**](./documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
* [**手机远程 Vibe Coding**](./documents/02-方法论/关于手机ssh任意位置链接本地计算机基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
* [**tmux快捷键大全**](./assets/documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。
* [**LazyVim快捷键大全**](./assets/documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
* [**手机远程 Vibe Coding**](./assets/documents/02-方法论/关于手机ssh任意位置链接本地计算机基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
### 外部教程与资源
@ -329,14 +329,14 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
### 项目内部文档
* [**胶水编程 (Glue Coding)**](./documents/00-基础指南/): 软件工程的圣杯与银弹Vibe Coding 的终极进化形态。
* [**Chat Vault**](./repo/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./repo/prompts-library/): 支持 Excel 与 Markdown 格式互转,包含数百个精选提示词。
* [**胶水编程 (Glue Coding)**](./assets/documents/00-基础指南/): 软件工程的圣杯与银弹Vibe Coding 的终极进化形态。
* [**Chat Vault**](./assets/repo/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./assets/repo/prompts-library/): 支持 Excel 与 Markdown 格式互转,包含数百个精选提示词。
* [**编程提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): 适用于 Vibe Coding 流程的专用提示词(云端表格)。
* [**系统提示词构建原则**](./documents/00-基础指南/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
* [**开发经验总结**](./documents/00-基础指南/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
* [**通用项目架构模板**](./documents/00-基础指南/通用项目架构模板.md): 多种项目类型的标准目录结构。
* [**Augment MCP 配置文档**](./documents/02-方法论/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
* [**系统提示词构建原则**](./assets/documents/00-基础指南/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
* [**开发经验总结**](./assets/documents/00-基础指南/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
* [**通用项目架构模板**](./assets/documents/00-基础指南/通用项目架构模板.md): 多种项目类型的标准目录结构。
* [**Augment MCP 配置文档**](./assets/documents/02-方法论/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
* [**系统提示词集合**](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1254297203#gid=1254297203): AI 开发的系统提示词,含多版本开发规范(云端表格)。
* [**外部资源(在线表格)**](./assets/README.md): 外部资源的唯一真相源(按类型分表),本地 Markdown 保留为历史参考。
@ -376,12 +376,33 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
├── assets/ # 外部资源(指向在线表格)
│ ├── README.md # 远程表格索引(唯一真相源)
│ └── AGENTS.md # assets/ 目录规则
├── config/ # 工具与开发配置
│ └── .codex/ # Codex CLI 配置(项目级)
│ ├── config.toml # Codex CLI 配置文件
│ └── AGENTS.md # Codex/Agent 指南(本目录)
│ ├── AGENTS.md # assets/ 目录规则
│ ├── config/ # 工具与开发配置
│ │ └── .codex/ # Codex CLI 配置(项目级)
│ │ ├── config.toml # Codex CLI 配置文件
│ │ └── AGENTS.md # Codex/Agent 指南(本目录)
│ ├── documents/ # 文档库
│ │ ├── 05-哲学与方法论/ # 最高思想纲领与方法论
│ │ ├── 00-基础指南/ # 核心原则与底层逻辑
│ │ ├── 01-入门指南/ # 从零开始教程
│ │ ├── 02-方法论/ # 具体工具与技巧
│ │ └── 03-实战/ # 项目实战案例
│ ├── workflow/ # 工作流模板
│ │ ├── auto-dev-loop/ # 自动开发循环
│ │ └── canvas-dev/ # Canvas白板驱动开发
│ └── repo/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── .github/ # GitHub 配置
│ ├── workflows/ # CI/CD 工作流
@ -394,13 +415,6 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
│ ├── FUNDING.yml # 赞助配置
│ └── wiki/ # GitHub Wiki 内容
├── documents/ # 文档库
│ ├── 05-哲学与方法论/ # 最高思想纲领与方法论
│ ├── 00-基础指南/ # 核心原则与底层逻辑
│ ├── 01-入门指南/ # 从零开始教程
│ ├── 02-方法论/ # 具体工具与技巧
│ ├── 03-实战/ # 项目实战案例
├── prompts/ # 提示词库(指向云端表格)
│ └── README.md # 在线表格链接
@ -415,24 +429,6 @@ Canvas方式**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
│ ├── tmux-autopilot/ # tmux 自动化
│ └── ... # 更多技能
├── workflow/ # 工作流模板
│ ├── auto-dev-loop/ # 自动开发循环
│ └── canvas-dev/ # Canvas白板驱动开发
├── repo/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
│ ├── 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)
├── tools/ # 工具目录(预留)
│ └── .gitkeep # 保持空目录被 Git 追踪
```
@ -462,11 +458,11 @@ prompts/
01-系统提示词/ # 约束 AI 行为边界的系统级提示词
02-编程提示词/ # 需求澄清、计划、执行链的核心提示词
03-用户提示词/ # 可复用的用户侧提示词
documents/
assets/documents/
00-基础指南/代码组织.md, 00-基础指南/通用项目架构模板.md, 00-基础指南/开发经验.md, 00-基础指南/系统提示词构建原则.md 等知识库
assets/
README.md # 外部资源(在线表格)唯一真相源入口
repo/backups/
assets/repo/backups/
一键备份.sh, 快速备份.py # 本地/远端快照脚本
```
@ -487,8 +483,8 @@ graph TB
subgraph ingest_layer[数据接入与采集层]
excel_raw[prompt_excel/*.xlsx]
md_raw[prompt_docs/外部MD输入]
excel_to_docs[repo/prompts-library/scripts/excel_to_docs.py]
docs_to_excel[repo/prompts-library/scripts/docs_to_excel.py]
excel_to_docs[assets/repo/prompts-library/scripts/excel_to_docs.py]
docs_to_excel[assets/repo/prompts-library/scripts/docs_to_excel.py]
ingest_bus[标准化数据帧]
ext_sheet --> excel_raw
ext_md --> md_raw
@ -508,11 +504,11 @@ graph TB
end
subgraph consume_layer[执行与消费层]
artifacts_md --> catalog_coding[prompts/编程提示词]
artifacts_md --> catalog_system[prompts/系统提示词]
artifacts_md --> catalog_meta[prompts/00-元提示词]
artifacts_md --> catalog_user[prompts/03-用户提示词]
artifacts_md --> docs_repo[documents/*]
artifacts_md --> catalog_coding[prompts(在线)/编程提示词]
artifacts_md --> catalog_system[prompts(在线)/系统提示词]
artifacts_md --> catalog_meta[prompts(在线)/元提示词]
artifacts_md --> catalog_user[prompts(在线)/用户提示词]
artifacts_md --> docs_repo[assets/documents/*]
artifacts_md --> new_consumer[预留:其他下游渠道]
catalog_coding --> ai_flow[AI 结对编程流程]
ai_flow --> deliverables[项目上下文 / 计划 / 代码产出]
@ -526,9 +522,9 @@ graph TB
subgraph infra_layer[基础设施与横切能力层]
git[Git 版本控制] --> orchestrator
backups[repo/backups/一键备份.sh · repo/backups/快速备份.py] --> artifacts_md
backups[assets/repo/backups/一键备份.sh · assets/repo/backups/快速备份.py] --> artifacts_md
deps[requirements.txt · scripts/requirements.txt] --> orchestrator
config[repo/prompts-library/scripts/config.yaml] --> orchestrator
config[assets/repo/prompts-library/scripts/config.yaml] --> orchestrator
monitor[预留:日志与监控] --> orchestrator
end
```

View File

@ -1,6 +1,14 @@
# assets/ 目录 Agent 指南
本目录用于收纳/索引“仓库外部资产”的**入口**,例如:
本目录用于统一收纳仓库的关键资产与索引入口,包含:
- `assets/README.md`:外部资源在线表格入口(唯一真相源)
- `assets/documents/`:知识库(方法论/入门/实战)
- `assets/workflow/`:工作流模板
- `assets/repo/`:外部工具与依赖镜像(含 Git submodule
- `assets/config/`:工具与开发配置(含 Codex CLI 配置)
其中“外部资源”类入口文档的典型形态包括:
- 在线表格(资源库、索引表、清单)
- 远程文档(规范、课程、外部知识库)
@ -9,5 +17,6 @@
## 约束
- 不在此目录存放敏感信息Token、私钥、个人隐私
- `assets/repo/` 下的第三方镜像/子模块:除非任务明确要求,否则不要做“顺手改动/格式化/批量替换”。
- 尽量只存“入口文档与说明”,不要复制粘贴大段第三方内容。
- 外部资产必须写清:用途、维护者、更新方式、与仓库内文档的关系(谁是唯一真相源)。

View File

@ -1,6 +1,12 @@
# 📎 Assets(外部资产索引)
# 📎 Assets
本目录用于为仓库中的“外部资产”提供**稳定入口**与**使用说明**,避免资源散落在多个 Markdown 文件里难以维护。
本目录用于统一收纳仓库的关键资产与索引入口:
- `assets/documents/`:知识库(方法论/入门/实战)
- `assets/workflow/`:工作流模板
- `assets/repo/`:外部工具与依赖镜像(含 Git submodule
- `assets/config/`:工具与开发配置(含 Codex CLI 配置)
- `assets/README.md`:外部资源在线表格入口(唯一真相源)
## 外部资源在线表格(唯一真相源)

View File

@ -151,7 +151,7 @@ AI 不再需要"发明"任何东西。它只需要:
## 📚 延伸阅读
- [语言层要素](./语言层要素.md) - 看懂 100% 代码必须掌握的 12 层要素
- [胶水开发提示词](../../prompts/02-编程提示词/胶水开发.md)
- [胶水开发提示词(在线提示词库入口)](../../../prompts/README.md)
- [项目实战polymarket-dev](../03-实战/polymarket-dev/)
---

View File

@ -188,7 +188,7 @@ Canvas方式
### 🔗 相关资源
- [Canvas白板生成提示词](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1777853069#gid=1777853069&range=A1) - 自动生成架构白板的完整提示词
- [白板驱动开发系统提示词](../../prompts/01-系统提示词/AGENTS.md/12/AGENTS.md) - 适配Canvas白板驱动开发的AGENTS.md
- [白板驱动开发系统提示词(在线提示词库入口)](../../../prompts/README.md) - 系统提示词已迁移到云端表格
- [Obsidian Canvas 官方文档](https://obsidian.md/canvas)
- [胶水编程](../00-基础指南/胶水编程.md) - 能抄不写,能连不造
- [通用项目架构模板](../00-基础指南/通用项目架构模板.md) - 标准化目录结构

View File

@ -1,6 +1,6 @@
# 人生K线 LLM 系统提示词(完整原文)
以下内容对应 `repo/libs/external/web/lifekline-main/constants.ts` 中的 `BAZI_SYSTEM_INSTRUCTION` 字符串,已原样展开,便于单独查看与复用。
以下内容整理自外部项目 `lifekline-main``BAZI_SYSTEM_INSTRUCTION` 字符串(该外部项目源码当前不随本仓库分发),已原样展开,便于单独查看与复用。
```
你是一位八字命理大师,精通加密货币市场周期。根据用户提供的四柱干支和大运信息,生成"人生K线图"数据和命理报告。

View File

@ -1,6 +1,6 @@
# 人生K线 LLM 用户提示词模板(完整原文)
本文件摘自 `repo/libs/external/web/lifekline-main/services/geminiService.ts``userPrompt` 拼装逻辑,已替换为模板变量,便于直接复用。
本文件整理自外部项目 `lifekline-main``userPrompt` 拼装逻辑(该外部项目源码当前不随本仓库分发),已替换为模板变量,便于直接复用。
```
请根据以下**已经排好的**八字四柱和**指定的大运信息**进行分析。

View File

@ -2,12 +2,12 @@
## 目录用途
`documents/` 存放项目知识库文档,包含方法论、入门指南、实战案例等。
`assets/documents/` 存放项目知识库文档,包含方法论、入门指南、实战案例等。
## 目录结构
```
documents/
assets/documents/
├── 05-哲学与方法论/ # 最高思想纲领
├── 00-基础指南/ # 核心原则与底层逻辑
├── 01-入门指南/ # 从零开始教程

View File

@ -5,7 +5,7 @@
## 🗺️ 目录结构
```
documents/
assets/documents/
├── 05-哲学与方法论/ # 最高思想纲领,底层逻辑
├── 00-基础指南/ # 核心理念,胶水编程,方法论
├── 01-入门指南/ # 从零开始,环境配置
@ -35,6 +35,6 @@ documents/
## 🔗 相关资源
- [提示词库](../prompts/) - AI 提示词资产
- [技能库](../skills/) - 模块化技能集
- [外部资源(在线表格)](../assets/README.md) - 外部资源唯一真相源入口
- [提示词库](../../prompts/) - AI 提示词资产
- [技能库](../../skills/) - 模块化技能集
- [外部资源(在线表格)](../README.md) - 外部资源唯一真相源入口

View File

@ -1,11 +1,11 @@
# repo/ 目录 Agent 指南
# assets/repo/ 目录 Agent 指南
本目录用于收纳 **外部工具/第三方项目**(含 Git submodule保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。
## 目录结构(约定)
```text
repo/
assets/repo/
├── AGENTS.md # 本文件(目录级行为准则)
├── README.md # 外部工具索引
├── .tmux/ # submoduleoh-my-tmux 配置

View File

@ -1,6 +1,6 @@
# 🔌 repo/:外部集成与第三方工具
# 🔌 assets/repo/:外部集成与第三方工具
`repo/` 用来收纳第三方工具、外部依赖与集成模块(含 Git submodule。核心原则是
`assets/repo/` 用来收纳第三方工具、外部依赖与集成模块(含 Git submodule。核心原则是
- **尽量原样保留**:避免“魔改后不可升级”
- **隔离依赖与风险**:外部工具的依赖不要污染主仓库
@ -9,7 +9,7 @@
## 目录结构
```
repo/
assets/repo/
├── AGENTS.md # 本目录的 Agent 行为准则
├── README.md # 本文件(外部工具索引)
├── .tmux/ # submoduleoh-my-tmux 配置
@ -36,11 +36,11 @@ repo/
- `XHS-image-to-PDF-conversion/`:图片合并 PDF详见 `XHS-image-to-PDF-conversion/README.md`
- `.tmux/`、`tmux/`、`claude-official-skills/`:以 submodule 形式引入的上游仓库
> 📝 `system-prompts-and-models-of-ai-tools-main-cn/` 已移至 [`prompts/system_prompts/`](../../prompts/system_prompts/)
> 📝 系统提示词已迁移到云端表格,入口见 [`prompts/README.md`](../../prompts/README.md)。
## 新增外部工具(最小清单)
1. 创建目录:`repo/<tool-name>/`
1. 创建目录:`assets/repo/<tool-name>/`
2. 必备文件:`README.md`(用途/入口/依赖/输入输出)、许可证与来源说明(如 `LICENSE` / `SOURCE.md`
3. 依赖约束:尽量使用工具自带的虚拟环境/容器化方式,不影响仓库其他部分
4. 文档同步:在本 README 增加一行工具说明,保证可发现性

Some files were not shown because too many files have changed in this diff Show More