Repository Guidelines

模块目录与技能名使用 kebab-case(如 content/skills/latex-paper-en/)。Rust 代码使用标准 Rust 格式化 (cargo fmt),静态分析使用 Clippy。TypeScript/React 遵循 ESLint 配置。

tools-only Updated 7 repo stars

File contents

Repository Guidelines

项目结构与模块组织

本仓库用于管理跨平台 AI 技能与命令。核心目录:content/skills/(本地技能模块,每个技能一个子目录含 SKILL.md)、content/commands/(各平台斜杠命令)、content/prompts/(全局提示词)、tools/external-skills/(外部技能注册),文档站点位于 docs/。技能管理通过 mcs/(Rust TUI)进行。工具类子项目位于 tools/(agentkit-desktop、external-skills、plugin-scripts)。

构建、测试与开发命令

常用命令如下:

just mcs                           # 启动交互式 Rust TUI(推荐)
just ci                            # 运行完整 CI 流程 (TypeScript + Rust)
just docs-dev                      # 文档站点开发
just rust-check-all                # Rust 格式 + Clippy + 测试

just 任务定义于 justfile,文档构建使用 docs/ 内的 npm 脚本。

编码风格与命名规范

模块目录与技能名使用 kebab-case(如 content/skills/latex-paper-en/)。Rust 代码使用标准 Rust 格式化 (cargo fmt),静态分析使用 Clippy。TypeScript/React 遵循 ESLint 配置。

测试指南

Rust 测试通过 cargo test 运行(mcs/ 和 tools/agentkit-desktop/src-tauri/)。TypeScript 类型检查使用 npx tsc --noEmit。

提交与 PR 规范

提交信息遵循 Conventional Commits:feat(scope): 描述、fix(docs): 描述、refactor(...) 等。请保持 scope 与变更模块一致(例如 feat(drawio): ...)。PR 建议包含:变更摘要、关联问题/需求、影响范围(如具体技能目录)、已运行的测试命令,若涉及 TUI 或文档,请附截图或预览说明。

安装与配置提示

默认通过 Rust TUI 管理技能:just mcs。跨平台目标在 TUI 中选择。

tools-only/X-Skills/tree/main/development/tools/028-agents_15ebd473 commit e597211234

Frequently asked questions

npx skillmds@latest add tools-only/repository-guidelines