chore: assets - reorganize resource directories

This commit is contained in:
tukuaiai
2026-04-28 18:36:03 +08:00
parent 33ded0d13e
commit f78d03236a
534 changed files with 338 additions and 816 deletions
+4 -1
View File
@@ -47,6 +47,9 @@ ENV/
*.log
logs/
# Local task workspaces
assets/tasks/
# Skill Seekers (vendored tool output)
output/
assets/skills/skills-skills/scripts/.venv-skill-seekers/
@@ -74,7 +77,7 @@ libs/external/.tmux
# Backup
backups/gz/
assets/repo/backups/gz/
assets/repos/backups/gz/
*.bak
*.tmp
+6 -6
View File
@@ -1,9 +1,9 @@
[submodule "repo/.tmux"]
path = assets/repo/.tmux
[submodule "repos/.tmux"]
path = assets/repos/.tmux
url = https://github.com/gpakosz/.tmux.git
[submodule "repo/tmux"]
path = assets/repo/tmux
[submodule "repos/tmux"]
path = assets/repos/tmux
url = https://github.com/tmux/tmux.git
[submodule "repo/claude-official-skills"]
path = assets/repo/claude-official-skills
[submodule "repos/claude-official-skills"]
path = assets/repos/claude-official-skills
url = https://github.com/anthropics/skills.git
+27 -32
View File
@@ -8,21 +8,21 @@
### 允许的操作
- 读取、修改顶层文档:`README.md``AGENTS.md``CONTRIBUTING.md`
- 读取、修改 `assets/documents/``assets/prompts/``assets/skills/``assets/workflow/``assets/config/``assets/tools/``assets/repo/` 下的文档与代码
- 读取、修改 `assets/documents/``assets/prompt/``assets/skills/``assets/config/``assets/repos/` 下的文档与代码
- 执行 `make lint`、备份脚本、prompts-library 转换工具
- 新增/修改提示词、技能、文档
- 提交符合规范的 commit
### 禁止的操作
- 修改 `.github/workflows/` 中的 CI 配置(除非任务明确要求)
- 删除或覆盖 `assets/repo/backups/gz/` 中的存档文件
- 删除或覆盖 `assets/repos/backups/gz/` 中的存档文件
- 修改 `LICENSE``CODE_OF_CONDUCT.md`
- 在代码中硬编码密钥、Token 或敏感凭证
- 未经确认的大范围重构
### 敏感区域(禁止自动修改)
- `.github/workflows/*.yml` - CI/CD 配置
- `assets/repo/backups/gz/` - 历史备份存档
- `assets/repos/backups/gz/` - 历史备份存档
- `.env*` 文件(如存在)
---
@@ -63,9 +63,9 @@ git push origin develop
|:---|:---|:---|
| `make help` | 列出所有 Make 目标 | 无 |
| `make lint` | 校验全仓库 Markdown | 需安装 markdownlint-cli |
| `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 |
| `bash assets/repos/backups/一键备份.sh` | 创建完整项目备份 | 无 |
| `python3 assets/repos/backups/快速备份.py` | Python 版备份脚本 | Python 3.8+ |
| `cd assets/repos/prompts-library && python3 main.py` | 提示词格式转换 | pandas, openpyxl, PyYAML |
### prompts-library 支持的转换模式
1. Excel → Docs:将 Excel 工作簿转换为 Markdown 文档目录
@@ -80,20 +80,19 @@ git push origin develop
### 架构原则
- 保持根目录扁平,避免巨石文件
- 三层内容架构:`assets/documents/` (知识) → `assets/prompts/` (指令) → `assets/skills/` (能力)
- 三层内容架构:`assets/documents/` (知识) → `assets/prompt/` (指令) → `assets/skills/` (能力)
### 模块边界
- `assets/documents/` - 中文知识库(方法论/入门/实战/资源)
- `assets/prompts/` - 提示词入口与云端索引
- `assets/prompt/` - 提示词入口与云端索引
- `assets/skills/` - 可复用技能库(每个子目录一个 Skill)
- `assets/workflow/` - 可复用工作流模板(自动开发闭环等)
- `assets/documents/workflow/` - 可复用工作流模板(自动开发闭环等)
- `assets/config/` - 工具与开发配置(例如 Codex CLI)
- `assets/tools/` - 预留:自定义脚本/小工具(保持可替换、可审计
- `assets/repo/` - 外部工具与依赖(含 Git submodule
- `assets/repos/` - 外部工具与依赖(含 Git submodule
### 依赖添加规则
- 新增工具或库时记录安装方式、最小版本与来源
- 外部依赖来源记录在 `assets/repo/` 目录下
- 外部依赖来源记录在 `assets/repos/` 目录下
- 引入第三方脚本需标明许可证与来源
### 禁止行为
@@ -150,25 +149,21 @@ git push origin develop
│ │ ├── guides/ # 入门与方法(getting-started + playbook
│ │ │ ├── getting-started/ # 原 01-入门指南
│ │ │ └── playbook/ # 原 02-方法论
│ │ ── case-studies/ # 原 03-实战
├── prompts/ # 提示词库(指向云端表格)
│ │ ── case-studies/ # 原 03-实战
│ └── workflow/ # 工作流模板
│ ├── prompt/ # 提示词库(指向云端表格)
│ │ ├── README.md # 在线表格链接
│ │ └── AGENTS.md # prompts/ 目录规则
│ │ └── AGENTS.md # prompt/ 目录规则
│ ├── skills/ # 技能库(扁平化,详见 assets/skills/README.md
│ │ ├── README.md # skills 总览与索引
│ │ ├── AGENTS.md # skills/ 目录规则
│ │ ├── skills-skills/ # 元技能核心
│ │ ├── auto-skill/ # 元技能核心
│ │ ├── sop-generator/ # SOP 生成
│ │ ├── canvas-dev/ # Canvas白板驱动开发
│ │ └── ... # 更多技能
── tools/ # 工具目录(预留
│ │ └── .gitkeep # 保持空目录被 Git 追踪
│ ├── workflow/ # 工作流模板
│ │ ├── auto-dev-loop/ # 自动开发循环
│ │ └── canvas-dev/ # Canvas白板驱动开发
│ └── repo/ # 外部工具与依赖镜像(含 Git submodule
── repos/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── AGENTS.md # assets/repo/ 目录规则
│ ├── AGENTS.md # assets/repos/ 目录规则
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
│ ├── chat-vault/ # AI 聊天记录保存工具
│ ├── Skill_Seekers-development/ # Skills 制作器
@@ -196,8 +191,8 @@ git push origin develop
### 关键入口文件
- `README.md` - 项目主文档,面向人类开发者
- `AGENTS.md` - AI Agent 操作手册(本文件)
- `assets/repo/prompts-library/main.py` - 提示词转换工具入口
- `assets/repo/backups/一键备份.sh` - 备份脚本入口
- `assets/repos/prompts-library/main.py` - 提示词转换工具入口
- `assets/repos/backups/一键备份.sh` - 备份脚本入口
- `assets/skills/tmux-autopilot/` - tmux 自动化操控技能(基于 oh-my-tmux,含 capture-pane/send-keys/蜂群巡检脚本)
- `assets/skills/sop-generator/` - SOP 生成与规范化技能(输入资料/需求 -> 标准 SOP
@@ -211,7 +206,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 assets/repo/backups/一键备份.sh` |
| 备份脚本权限不足 | Shell 脚本无执行权限 | `chmod +x assets/repos/backups/一键备份.sh` |
---
@@ -270,25 +265,25 @@ feat|fix|docs|chore|refactor|test: scope - summary
```bash
# 提示词库转换
cd assets/repo/prompts-library && python3 main.py
cd assets/repos/prompts-library && python3 main.py
# Lint 所有 Markdown 文件
make lint
# 创建完整项目备份
bash assets/repo/backups/一键备份.sh
bash assets/repos/backups/一键备份.sh
```
## Architecture & Structure
### Core Directories
- **`assets/prompts/`**: 提示词库入口(指向云端表格)
- **`assets/prompt/`**: 提示词库入口(指向云端表格)
- **`assets/skills/`**: 扁平化技能库(详见 assets/skills/README.md
- **`assets/documents/`**: 知识库(principles、guides、case-studies
- **`assets/`**: 外部资源(在线表格)入口与使用说明
- **`assets/repo/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`assets/repo/chat-vault/`**: AI 聊天记录保存工具
- **`assets/repo/backups/`**: 备份脚本与存档
- **`assets/repos/prompts-library/`**: Excel ↔ Markdown 转换工具
- **`assets/repos/chat-vault/`**: AI 聊天记录保存工具
- **`assets/repos/backups/`**: 备份脚本与存档
### Key Technical Details
1. **Prompt Organization**: 提示词使用 `(row,col)_` 前缀进行分类
+15 -19
View File
@@ -315,7 +315,7 @@ Canvas方式:**代码 ⇄ 白板 ⇄ 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): 可用于快速搭建标准化的项目目录结构。
* [**元技能:Skills 的 Skills**](./assets/skills/skills-skills/SKILL.md): 用于生成 Skills 的元技能。
* [**元技能: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 的快捷键参考文档。
@@ -334,8 +334,8 @@ Canvas方式:**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
### 项目内部文档
* [**胶水编程 (Glue Coding)**](./assets/documents/principles/fundamentals/): 软件工程的圣杯与银弹,Vibe Coding 的终极进化形态。
* [**Chat Vault**](./assets/repo/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./assets/repo/prompts-library/): 支持 Excel 与 Markdown 格式互转,并支持将内部 JSONL Excel 按工作表拆分导出为 JSONL 目录。
* [**Chat Vault**](./assets/repos/chat-vault/): AI 聊天记录保存工具,支持 Codex/Kiro/Gemini/Claude CLI。
* [**prompts-library 工具说明**](./assets/repos/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): 变量命名、文件结构、编码规范、架构原则等。
@@ -393,23 +393,19 @@ Canvas方式:**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
│ │ ├── guides/ # 入门与方法(getting-started + playbook
│ │ │ ├── getting-started/ # 原 01-入门指南
│ │ │ └── playbook/ # 原 02-方法论
│ │ ── case-studies/ # 原 03-实战
├── prompts/ # 提示词库(指向云端表格)
│ │ ── case-studies/ # 原 03-实战
│ └── workflow/ # 工作流模板
│ ├── prompt/ # 提示词库(指向云端表格)
│ │ ├── README.md # 在线表格链接
│ │ └── AGENTS.md # prompts/ 目录规则
│ │ └── AGENTS.md # prompt/ 目录规则
│ ├── skills/ # 技能库(扁平化)
│ │ ├── README.md # skills 总览与索引
│ │ ├── AGENTS.md # skills/ 目录规则
│ │ ├── skills-skills/ # 元技能核心
│ │ ├── auto-skill/ # 元技能核心
│ │ ├── sop-generator/ # SOP 生成
│ │ ├── canvas-dev/ # Canvas白板驱动开发
│ │ └── ... # 更多技能
── tools/ # 工具目录(预留
│ │ └── .gitkeep # 保持空目录被 Git 追踪
│ ├── workflow/ # 工作流模板
│ │ ├── auto-dev-loop/ # 自动开发循环
│ │ └── canvas-dev/ # Canvas白板驱动开发
│ └── repo/ # 外部工具与依赖镜像(含 Git submodule
── repos/ # 外部工具与依赖镜像(含 Git submodule
│ ├── README.md # 外部工具索引
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具,含内部 JSONL Excel 拆分导出
│ ├── chat-vault/ # AI 聊天记录保存工具
@@ -455,7 +451,7 @@ Canvas方式:**代码 ⇄ 白板 ⇄ AI ⇄ 人类**,白板成为单一真
核心资产映射:
```
assets/prompts/
assets/prompt/
README.md # 云端表格入口(元/系统/编程/用户提示词)
assets/skills/
README.md # skills 总览与索引
@@ -463,7 +459,7 @@ assets/documents/
principles/fundamentals/*, principles/philosophy/*, guides/*, case-studies/* 等知识库
assets/
README.md # 外部资源(在线表格)唯一真相源入口
assets/repo/backups/
assets/repos/backups/
一键备份.sh, 快速备份.py # 本地/远端快照脚本
```
@@ -484,8 +480,8 @@ graph TB
subgraph ingest_layer[数据接入与采集层]
excel_raw[prompt_excel/*.xlsx]
md_raw[prompt_docs/外部MD输入]
excel_to_docs[assets/repo/prompts-library/scripts/excel_to_docs.py]
docs_to_excel[assets/repo/prompts-library/scripts/docs_to_excel.py]
excel_to_docs[assets/repos/prompts-library/scripts/excel_to_docs.py]
docs_to_excel[assets/repos/prompts-library/scripts/docs_to_excel.py]
ingest_bus[标准化数据帧]
ext_sheet --> excel_raw
ext_md --> md_raw
@@ -523,9 +519,9 @@ graph TB
subgraph infra_layer[基础设施与横切能力层]
git[Git 版本控制] --> orchestrator
backups[assets/repo/backups/一键备份.sh · assets/repo/backups/快速备份.py] --> artifacts_md
backups[assets/repos/backups/一键备份.sh · assets/repos/backups/快速备份.py] --> artifacts_md
deps[requirements.txt · scripts/requirements.txt] --> orchestrator
config[assets/repo/prompts-library/scripts/config.yaml] --> orchestrator
config[assets/repos/prompts-library/scripts/config.yaml] --> orchestrator
monitor[预留:日志与监控] --> orchestrator
end
```
+4 -5
View File
@@ -4,12 +4,11 @@
- `assets/README.md`:外部资源在线表格入口(唯一真相源)
- `assets/documents/`:知识库(方法论/入门/实战)
- `assets/prompts/`:提示词库入口(指向云端表格)
- `assets/prompt/`:提示词库入口(指向云端表格)
- `assets/skills/`:技能库(可复用 Skills
- `assets/workflow/`:工作流模板
- `assets/repo/`:外部工具与依赖镜像(含 Git submodule
- `assets/documents/workflow/`:工作流模板
- `assets/repos/`:外部工具与依赖镜像(含 Git submodule
- `assets/config/`:工具与开发配置(含 Codex CLI 配置)
- `assets/tools/`:工具目录(预留)
其中“外部资源”类入口文档的典型形态包括:
@@ -20,6 +19,6 @@
## 约束
- 不在此目录存放敏感信息(Token、私钥、个人隐私)。
- `assets/repo/` 下的第三方镜像/子模块:除非任务明确要求,否则不要做“顺手改动/格式化/批量替换”。
- `assets/repos/` 下的第三方镜像/子模块:除非任务明确要求,否则不要做“顺手改动/格式化/批量替换”。
- 尽量只存“入口文档与说明”,不要复制粘贴大段第三方内容。
- 外部资产必须写清:用途、维护者、更新方式、与仓库内文档的关系(谁是唯一真相源)。
+3 -4
View File
@@ -3,12 +3,11 @@
本目录用于统一收纳仓库的关键资产与索引入口:
- `assets/documents/`:知识库(方法论/入门/实战)
- `assets/prompts/`:提示词库入口(指向云端表格)
- `assets/prompt/`:提示词库入口(指向云端表格)
- `assets/skills/`:技能库(可复用 Skills
- `assets/workflow/`:工作流模板
- `assets/repo/`:外部工具与依赖镜像(含 Git submodule
- `assets/documents/workflow/`:工作流模板
- `assets/repos/`:外部工具与依赖镜像(含 Git submodule
- `assets/config/`:工具与开发配置(含 Codex CLI 配置)
- `assets/tools/`:工具目录(预留)
- `assets/README.md`:外部资源在线表格入口(唯一真相源)
## 外部资源在线表格(唯一真相源)
+76 -2
View File
@@ -4,7 +4,8 @@
# - 这里填写 Codex CLI 支持的模型名(字符串)。
# - 建议写成你常用的默认模型,临时切换用命令行 `-m` 覆盖更合适。
# - 经验上:`*-codex` 更偏“写代码/改代码”,非 `*-codex` 更偏通用对话(以你实际使用体验为准)。
model = "gpt-5.4"
model = "gpt-5.5"
model_provider = "openai-http"
# 推理强度(思考深度):
# - low → 更快,适合“明确指令 + 小改动”
@@ -13,7 +14,7 @@ model = "gpt-5.4"
# - xhigh → 最深,适合架构级设计/大范围推理(可能更慢)
# 注意:
# - 不同模型对选项支持范围可能不同;遇到报错优先降一档再试。
model_reasoning_effort = "xhigh"
model_reasoning_effort = "medium"
# 运行策略
# sandbox_mode
@@ -56,9 +57,22 @@ startup_timeout_ms = 20000
# 是否在 TUI(终端 UI)里启用通知提示。
notifications = true
[tui.model_availability_nux]
"gpt-5.5" = 3
[features]
# Codex 里的 “subagent” 基本就是 Multi-agents(多代理/子线程)功能:主代理会按需 spawn 子代理并行干活,最后汇总结果。
multi_agent = true
# 禁用 Responses WebSocket 传输,只走 HTTPS/HTTP Responses。
responses_websockets = false
responses_websockets_v2 = false
[model_providers.openai-http]
# 自定义 provider 不能覆盖内置 openai,所以用新 ID 复制 OpenAI/Responses 语义并关闭 WebSocket 能力。
name = "OpenAI"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
[notice]
# 这些开关用于隐藏某些“迁移/提示”类消息,减少噪音(仅影响 UI,不影响核心功能)。
@@ -73,6 +87,66 @@ hide_rate_limit_model_nudge = true
"gpt-5.1-codex-max" = "gpt-5.2-codex"
"gpt-5.2" = "gpt-5.4"
[projects."/home/lenovo/.projects/cat/tradecat"]
trust_level = "trusted"
[projects."/home/lenovo/zip/vibe-coding-cn"]
trust_level = "trusted"
[projects."/mnt/c/Users/13208"]
trust_level = "trusted"
[projects."/home/lenovo"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat/zip/tradecat-20260324"]
trust_level = "trusted"
[projects."/mnt/c/Users/13208/Downloads"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/skill"]
trust_level = "trusted"
[projects."/mnt/d/.projects/研究/tasks+任务包"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat/tradecat-public"]
trust_level = "trusted"
[projects."/mnt/d/.projects/研究/dataset-first"]
trust_level = "trusted"
[projects."/mnt/d/.projects/研究/女娲/raw/cz-skill"]
trust_level = "trusted"
[projects."/home/lenovo/.codex"]
trust_level = "trusted"
[projects."/mnt/d/.projects/研究/币安人生"]
trust_level = "trusted"
[projects."/mnt/d/.projects/XHS-Downloader"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat/fatecat"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat/predictcat"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/cat/catkey"]
trust_level = "trusted"
[projects."/mnt/d/.projects/研究/raw/量化交易/交易猫开发实践"]
trust_level = "trusted"
[projects."/home/lenovo/.projects/vibe-coding-cn"]
trust_level = "trusted"
# ==================== MCP Servers(示例,默认关闭) ====================
# 说明:
# - 下面这些块默认都注释掉,作为“可复制的模板”。
+5 -2
View File
@@ -12,7 +12,8 @@ assets/documents/
├── guides/ # 入门与方法(getting-started + playbook
│ ├── getting-started/ # 原 01-入门指南
│ └── playbook/ # 原 02-方法论
── case-studies/ # 原 03-实战
── case-studies/ # 原 03-实战
└── workflow/ # 可复用工作流模板
```
## 🚀 快速导航
@@ -22,6 +23,7 @@ assets/documents/
| [principles](./principles/) | 原则与思想(基础 + 哲学) | 架构师与深度开发者 |
| [guides](./guides/) | 入门与方法(上手 + 工具与经验) | 新手入门与效率提升 |
| [case-studies](./case-studies/) | 项目经验、案例复盘 | 动手实践 |
| [workflow](./workflow/) | 自动化工作流模板 | Agent 编排与流程复用 |
## 📖 推荐学习路径
@@ -32,9 +34,10 @@ assets/documents/
5. **工具** → [tmux 快捷键](./guides/playbook/tmux快捷键大全.md)
6. **远程** → [VS Code Remote TunnelWSL](./guides/playbook/REMOTE_TUNNEL_GUIDE.md)
7. **实践** → [项目实战经验](./case-studies/)
8. **流程** → [工作流模板](./workflow/)
## 🔗 相关资源
- [提示词库](../prompts/) - AI 提示词资产
- [提示词库](../prompt/) - AI 提示词资产
- [技能库](../skills/) - 模块化技能集
- [外部资源(在线表格)](../README.md) - 外部资源唯一真相源入口
@@ -188,7 +188,7 @@ Canvas方式:
### 🔗 相关资源
- [Canvas白板生成提示词](https://docs.google.com/spreadsheets/d/1Ifk_dLF25ULSxcfGem1hXzJsi7_RBUNAki8SBCuvkJA/edit?gid=1777853069#gid=1777853069&range=A1) - 自动生成架构白板的完整提示词
- [白板驱动开发系统提示词(在线提示词库入口)](../../../prompts/README.md) - 系统提示词已迁移到云端表格
- [白板驱动开发系统提示词(在线提示词库入口)](../../../prompt/README.md) - 系统提示词已迁移到云端表格
- [Obsidian Canvas 官方文档](https://obsidian.md/canvas)
- [胶水编程](../../principles/fundamentals/胶水编程.md) - 能抄不写,能连不造
- [通用项目架构模板](../../principles/fundamentals/通用项目架构模板.md) - 标准化目录结构
@@ -151,7 +151,7 @@ AI 不再需要"发明"任何东西。它只需要:
## 📚 延伸阅读
- [语言层要素](./语言层要素.md) - 看懂 100% 代码必须掌握的 12 层要素
- [胶水开发提示词(在线提示词库入口)](../../../prompts/README.md)
- [胶水开发提示词(在线提示词库入口)](../../../prompt/README.md)
- [项目实战:polymarket-dev](../../case-studies/polymarket-dev/)
---
@@ -1,11 +1,11 @@
# Workflow 目录 Agent 指南
`assets/workflow/` 存放可复用的工作流模板:把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。
`assets/documents/workflow/` 存放可复用的工作流模板:把“需求 → 计划 → 实施 → 验证 → 总控复盘”等流程固化为可重复、可审计的自动化路径。
## 目录结构(当前)
```text
assets/workflow/
assets/documents/workflow/
├── AGENTS.md # 本文件(目录级行为准则)
├── README.md # workflow 总览
├── auto-dev-loop/ # 全自动开发闭环(五步状态机)
@@ -5,7 +5,7 @@
## 目录结构
```
assets/workflow/
assets/documents/workflow/
├── auto-dev-loop/ # 全自动开发闭环工作流(五步Agent)
├── <其他工作流>/
└── README.md
@@ -51,6 +51,6 @@ canvas-dev/
## 相关文档
- [Canvas白板驱动开发详解](../../documents/guides/playbook/图形化AI协作-Canvas白板驱动开发.md)
- [白板驱动开发系统提示词(在线提示词库入口)](../../prompts/README.md)
- [胶水编程](../../documents/principles/fundamentals/胶水编程.md)
- [Canvas白板驱动开发详解](../../guides/playbook/图形化AI协作-Canvas白板驱动开发.md)
- [白板驱动开发系统提示词(在线提示词库入口)](../../../prompt/README.md)
- [胶水编程](../../principles/fundamentals/胶水编程.md)
@@ -1,8 +1,8 @@
# Prompts 目录 Agent 指南
# Prompt 目录 Agent 指南
## 目录用途
`assets/prompts/` 提示词库入口,实际内容已迁移至云端表格。
`assets/prompt/` 提示词库入口,实际内容已迁移至云端表格。
## 在线资源
@@ -29,4 +29,4 @@
## 相关工具
- `assets/repo/prompts-library/` - Excel ↔ Markdown 互转工具
- `assets/repos/prompts-library/` - Excel ↔ Markdown 互转工具
@@ -25,7 +25,7 @@
- [技能库](../skills/) - 比提示词更高级的能力封装
- [文档库](../documents/) - 方法论与开发经验
- [prompts-library 工具](../repo/prompts-library/)
- [prompts-library 工具](../repos/prompts-library/)
Excel ↔ Markdown 互转工具
## 原版表格
@@ -1,11 +1,11 @@
# assets/repo/ 目录 Agent 指南
# assets/repos/ 目录 Agent 指南
本目录用于收纳 **外部工具/第三方项目**(含 Git submodule),保持“主仓库资产”和“外部依赖”边界清晰、可审计、可更新。
## 目录结构(约定)
```text
assets/repo/
assets/repos/
├── AGENTS.md # 本文件(目录级行为准则)
├── README.md # 外部工具索引
├── .tmux/ # submoduleoh-my-tmux 配置
@@ -1,6 +1,6 @@
# 🔌 assets/repo/:外部集成与第三方工具
# 🔌 assets/repos/:外部集成与第三方工具
`assets/repo/` 用来收纳第三方工具、外部依赖与集成模块(含 Git submodule)。核心原则是:
`assets/repos/` 用来收纳第三方工具、外部依赖与集成模块(含 Git submodule)。核心原则是:
- **尽量原样保留**:避免“魔改后不可升级”
- **隔离依赖与风险**:外部工具的依赖不要污染主仓库
@@ -9,7 +9,7 @@
## 目录结构
```
assets/repo/
assets/repos/
├── AGENTS.md # 本目录的 Agent 行为准则
├── README.md # 本文件(外部工具索引)
├── .tmux/ # submoduleoh-my-tmux 配置
@@ -36,11 +36,11 @@ assets/repo/
- `XHS-image-to-PDF-conversion/`:图片合并 PDF(详见 `XHS-image-to-PDF-conversion/README.md`
- `.tmux/``tmux/``claude-official-skills/`:以 submodule 形式引入的上游仓库
> 📝 系统提示词已迁移到云端表格,入口见 [`assets/prompts/README.md`](../prompts/README.md)。
> 📝 系统提示词已迁移到云端表格,入口见 [`assets/prompt/README.md`](../prompt/README.md)。
## 新增外部工具(最小清单)
1. 创建目录:`assets/repo/<tool-name>/`
1. 创建目录:`assets/repos/<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