My Skills 是一个独立、可复用的智能体 Skill 库。它为项目创建、架构治理、代码接手和仓库文字质量提供成熟工程兜底，但不会把某个框架、目录树或个人偏好强制成唯一答案。
- 默认方案来自目标生态的官方工具链、成熟框架和长期维护实践，不从空白随意发明。
- 默认值只是信息不足时的安全起点；只要真实约束、收益、成本和验证证据充分，就可以采用更优方案。
- 先判断产品形态、团队能力、部署方式和生命周期，再选择技术栈、依赖和结构。
- 只读审查只输出证据，不修改业务代码；只有明确实现授权后才写入目标项目。
- 每个 Skill 独立工作。它可以按需与其他 Skill 协作，但不把 My Workflow 或某个客户端设为硬依赖。
| Skill | 用途 | 调用示例 |
|---|---|---|
manage-myskills |
查看 My Skills 云端目录，并在用户明确选择后把指定 Skill 安装到共享或工具私有目录 | 使用 $manage-myskills 查看云端 Skill 列表。 |
design-project-architecture |
为 Java、Python、Go、Rust 等项目调查和设计技术栈、依赖、模块边界与演进结构；也能在明确授权后落地新项目或重构现有结构 | 使用 $design-project-architecture 为这个项目选择技术栈并设计可维护结构。 |
review-code-maintainability |
审查职责、耦合、生命周期、抽象净收益和真人接手质量 | 使用 $review-code-maintainability 审查当前 diff。 |
review-repository-prose |
审查注释、README、错误提示、配置说明和其他仓库文字 | 使用 $review-repository-prose 审查当前 diff 的公开文字。 |
design-project-architecture 的核心目标不是复制 RuoYi、Django、Kratos、Axum 或任何固定模板，而是让 Agent 从零创建项目时拥有成熟成品基线：使用目标生态适合的稳定技术、最小必要依赖、清晰结构、真实入口、测试和可恢复发布能力。成熟框架是证据来源和兜底，不是实现上限。
My Skills 保持为纯 Skill 仓库，不提供常驻管理器。首次使用时，优先通过目标客户端已有的 Skill 安装能力，只接入仓库 Viviana-Luna/myskills 中的 skills/manage-myskills。使用 Codex 时，可以让 Agent 调用 $skill-installer 完成这个 Bootstrap；也可以把该单个目录接入任何兼容 SKILL.md 的客户端。
接入后可以调用：
使用 $manage-myskills 查看云端 Skill 列表。
安装前由用户选择目标：
~/.agents/skills：支持 Agent Skills 共享目录的多个工具共同使用。- Codex 私有目录：
${CODEX_HOME:-~/.codex}/skills。 - Claude Code 私有目录：
~/.claude/skills。 - Kimi Code 私有目录：
${KIMI_CODE_HOME:-~/.kimi-code}/skills。 - OpenCode 私有目录：
${XDG_CONFIG_HOME:-~/.config}/opencode/skills。 - 其他工具：用户提供明确的绝对 Skill 根目录。
核心 Skill 默认只预览来源、稳定发布引用、逻辑与物理目标、文件列表和 SHA-256；只有用户明确选择安装目标，并把预览返回的引用、摘要和物理目标一并用于确认后才执行。预览与应用之间内容或路径指向发生变化时中止；已有同名目录时也中止，不自动覆盖或更新。
仓库本身不自动写入 ~/.agents/skills、~/.codex/skills 或其他全局目录，也不要求安装 My Workflow。调用名称以各目录中 SKILL.md 的 name 为准。
catalog.json
skills/
├── manage-myskills/
├── design-project-architecture/
├── review-code-maintainability/
└── review-repository-prose/
tests/
scripts/
└── validate.py
catalog.json 是云端 Skill 列表的机器可读索引；仓库校验器保证它与真实目录、版本和稳定发布标签一致。每个 Skill 的入口位于 SKILL.md，客户端展示信息位于 agents/openai.yaml，详细规则放在 references/ 并由入口按需加载。
python3 -m unittest discover -s tests -v
python3 scripts/validate.py修改 Skill 时，还应使用目标客户端或 Skill 创建工具提供的校验器逐个检查，并对关键触发、只读边界和实现授权场景做前向测试。自动化结构测试不能替代真实行为评估。
仓库采用语义化版本并在根目录 VERSION 记录当前版本。标签使用 v<版本>。catalog.json 只把安装指向当前稳定标签，不从未发布提交安装。Skill 的稳定调用名是兼容标识；重命名时必须提供明确迁移说明，不能静默创建第二份同义 Skill。
修改前请阅读 CONTRIBUTING.md 和 AGENTS.md。所有公开说明、注释、测试描述和提交信息使用简体中文；代码标识符、协议字段和第三方专有名称遵循生态惯例。
当前版本采用 Apache License 2.0（SPDX：Apache-2.0）发布，版权与分发说明见 NOTICE。