diff --git a/.github/lint_config.json b/.github/lint_config.json new file mode 100644 --- /dev/null +++ b/.github/lint_config.json @@ -0,0 +1,49 @@ +{ + "default": true, + + "MD001": false, + "MD003": false, + "MD004": false, + "MD005": false, + "MD007": false, + "MD009": false, + "MD010": false, + "MD012": false, + "MD013": false, + "MD014": false, + "MD018": false, + "MD019": false, + "MD022": false, + "MD023": false, + "MD024": false, + "MD025": false, + "MD026": false, + "MD027": false, + "MD028": false, + "MD029": false, + "MD030": false, + "MD031": false, + "MD032": false, + "MD033": false, + "MD034": false, + "MD036": false, + "MD037": false, + "MD038": false, + "MD039": false, + "MD040": false, + "MD041": false, + "MD042": false, + "MD045": false, + "MD046": false, + "MD047": false, + "MD049": false, + "MD050": false, + "MD051": false, + "MD052": false, + "MD053": false, + "MD055": false, + "MD056": false, + "MD058": false, + "MD059": false, + "MD060": false +} diff --git a/Makefile b/Makefile --- a/Makefile +++ b/Makefile @@ -16,7 +16,7 @@ lint: @echo "Linting markdown files..." @npm install -g markdownlint-cli - @markdownlint **/*.md + @markdownlint --config .github/lint_config.json '**/*.md' build: @echo "Building the project..." diff --git a/.gitignore b/.gitignore --- a/.gitignore +++ b/.gitignore @@ -48,7 +48,7 @@ # Skill Seekers (vendored tool output) output/ -skills/skills-skills/scripts/.venv-skill-seekers/ +assets/skills/skills-skills/scripts/.venv-skill-seekers/ libs/external/tmux libs/external/.tmux @@ -73,6 +73,7 @@ # Backup backups/gz/ +assets/repo/backups/gz/ *.bak *.tmp diff --git a/assets/config/.codex/README.md b/assets/config/.codex/README.md --- a/assets/config/.codex/README.md +++ b/assets/config/.codex/README.md @@ -1,11 +1,11 @@ -# `config/.codex/` 用法说明 +# `assets/config/.codex/` 用法说明 本目录用于在仓库内版本化管理 Codex CLI 的“全局配置基线”,便于多人同步、审阅与回滚。 你只需要把本目录里的两个文件复制到 **Codex Home**(默认 `~/.codex/`)即可生效: -- `config/.codex/config.toml` → `~/.codex/config.toml` -- `config/.codex/AGENTS.md` → `~/.codex/AGENTS.md` +- `assets/config/.codex/config.toml` → `~/.codex/config.toml` +- `assets/config/.codex/AGENTS.md` → `~/.codex/AGENTS.md` ## 1. 一键安装(推荐) @@ -13,8 +13,8 @@ ```bash mkdir -p ~/.codex -cp -f config/.codex/config.toml ~/.codex/config.toml -cp -f config/.codex/AGENTS.md ~/.codex/AGENTS.md +cp -f assets/config/.codex/config.toml ~/.codex/config.toml +cp -f assets/config/.codex/AGENTS.md ~/.codex/AGENTS.md ``` ## 2. 路径示例 diff --git a/assets/skills/skills-skills/references/skill-spec.md b/assets/skills/skills-skills/references/skill-spec.md --- a/assets/skills/skills-skills/references/skill-spec.md +++ b/assets/skills/skills-skills/references/skill-spec.md @@ -107,5 +107,5 @@ Before shipping, run the checklist in `quality-checklist.md` and (if available) the validator: ```bash -./skills/skills-skills/scripts/validate-skill.sh skills/ --strict +./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/ --strict ``` diff --git a/assets/skills/skills-skills/references/skill-seekers.md b/assets/skills/skills-skills/references/skill-seekers.md --- a/assets/skills/skills-skills/references/skill-seekers.md +++ b/assets/skills/skills-skills/references/skill-seekers.md @@ -4,16 +4,16 @@ ## 目录约定 -- 工具源码:`skills/skills-skills/scripts/Skill_Seekers-development/` -- 运行入口:`skills/skills-skills/scripts/skill-seekers.sh` -- 依赖初始化:`skills/skills-skills/scripts/skill-seekers-bootstrap.sh` -- 导入到本仓库:`skills/skills-skills/scripts/skill-seekers-import.sh` -- 更新源码快照:`skills/skills-skills/scripts/skill-seekers-update.sh`(需要网络) +- 工具源码:`assets/skills/skills-skills/scripts/Skill_Seekers-development/` +- 运行入口:`assets/skills/skills-skills/scripts/skill-seekers.sh` +- 依赖初始化:`assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh` +- 导入到本仓库:`assets/skills/skills-skills/scripts/skill-seekers-import.sh` +- 更新源码快照:`assets/skills/skills-skills/scripts/skill-seekers-update.sh`(需要网络) ## 推荐工作流(强约束) 1. 用 Skill Seekers 生成初稿到 `output//` -2. 导入到 `skills//` +2. 导入到 `assets/skills//` 3. 用 `validate-skill.sh --strict` 做质量闸门 4. 回到 `skills-skills` 的规范对 `SKILL.md` 做“可激活性”与“边界”修订 @@ -21,16 +21,16 @@ ```bash # 1) 初始化(只需一次) -./skills/skills-skills/scripts/skill-seekers-bootstrap.sh +./assets/skills/skills-skills/scripts/skill-seekers-bootstrap.sh # 2) 生成(示例:抓 docs 配置) -./skills/skills-skills/scripts/skill-seekers.sh -- scrape --config ./skills/skills-skills/scripts/Skill_Seekers-development/configs/react.json +./assets/skills/skills-skills/scripts/skill-seekers.sh -- scrape --config ./assets/skills/skills-skills/scripts/Skill_Seekers-development/configs/react.json # 3) 导入到 skills/ -./skills/skills-skills/scripts/skill-seekers-import.sh react +./assets/skills/skills-skills/scripts/skill-seekers-import.sh react # 4) 严格校验 -./skills/skills-skills/scripts/validate-skill.sh skills/react --strict +./assets/skills/skills-skills/scripts/validate-skill.sh assets/skills/react --strict ``` ## 设计原则