GitHubHelp

fengzai6/skills

★ 1Forks 0PythonGitHub ↗Compare

README

Skills 仓库

本仓库用于存放和管理自定义 rules 与 skills。

当前内容

可用 Rules

  • main
    • 路径: rules/main.md (5717 tokens)
    • 用途: 默认通用规则，全局行为约束与通用编码规范，所有项目通用，应放置在 ~/.claude/CLAUDE.md 中始终生效，正常使用时复制这个文件内容即可
  • codegraph
    • 路径: rules/codegraph.md (438 tokens)
    • 用途: CodeGraph 相关补充规则，只有在用户明确需要 CodeGraph 约束时才和 main 一起复制

可用 Skills

  • ts-standards
  • business-roadmap
    • 路径: skills/business-roadmap/SKILL.md (636 tokens)
    • 用途: 用户主动调用时进行业务宏观规划，梳理发展方向、演进阶段、关键依赖与成功判据
  • code-review
    • 路径: skills/code-review/SKILL.md (594 tokens)
    • 用途: 对代码变更、diff、commit 或实现做只读审查，按正确性、安全、性能、可维护性、风格排序输出 findings
  • pr-review
    • 路径: skills/pr-review/SKILL.md (592 tokens)
    • 用途: 基于 code-review 审查 PR，结尾询问是否将结论回复到 PR
  • handle-review
    • 路径: skills/handle-review/SKILL.md (678 tokens)
    • 用途: 验证 PR review 或用户提供的 review 结论，并派一个 subagent 处理确认成立的修复
  • spec-review
    • 路径: skills/spec-review/SKILL.md (764 tokens)
    • 用途: 审查 spec、设计文档或技术方案文档，给出修改建议、设计改进意见和补充建议
  • git-workflow
    • 路径: skills/git-workflow/SKILL.md (2583 tokens)
    • 用途: Git 本地提交与 issue/PR 收尾约定（分支命名、commit、gh 沙箱、PR body 模板）
  • test-review
    • 路径: skills/test-review/SKILL.md (1235 tokens)
    • 用途: 用户点名、即将开 PR、或大任务完成怕遗漏时审查测试完备性并按需补测
  • man-day-quote
    • 路径: skills/man-day-quote/SKILL.md (2162 tokens)
    • 用途: 人天报价（调用后先问方式与落地路径；线 A 直接估 / 线 B 先设计再估；确认后 py 生成 xlsx）

目录结构

skills/
├── _template/                  # Skill 模板
│   ├── SKILL.template.md       # 【必需】核心文件模板（复制后重命名为 SKILL.md）
│   ├── README.md               # 给人类看的说明模板
│   └── examples.md             # Few-shot 示例模板
├── rules/                      # 通用规则与可选补充规则
│   ├── main.md                 # 默认通用规则
│   └── codegraph.md            # CodeGraph 可选规则
├── skills/                     # Skills 目录
│   ├── ts-standards/           # TypeScript / React 相关 skill
│   │   └── SKILL.md
│   ├── business-roadmap/       # 业务宏观规划 skill
│   │   ├── SKILL.md
│   │   └── agents/
│   │       └── openai.yaml
│   ├── code-review/            # 代码审查 skill
│   │   └── SKILL.md
│   ├── pr-review/              # PR 审查 skill
│   │   └── SKILL.md
│   ├── handle-review/          # Review 结论处理 skill
│   │   └── SKILL.md
│   ├── spec-review/            # Spec 文档审查 skill
│   │   └── SKILL.md
│   ├── git-workflow/           # Git 提交与 PR 收尾 skill
│   │   └── SKILL.md
│   ├── test-review/            # 测试完备性审查 skill
│   │   └── SKILL.md
│   └── man-day-quote/          # 人天报价 skill
│       ├── SKILL.md
│       └── scripts/
│           └── generate-quote-xlsx.py
├── CLAUDE.md                   # 本仓库编写规范
└── README.md                   # 本文件

如何新建 Skill

  1. 复制 _template/ 目录并重命名为你的 skill 名称（kebab-case）
  2. 将 SKILL.template.md 重命名为 SKILL.md
  3. 按需补充 README.md、examples.md、scripts/、references/、assets/、tests/
  4. 保持内容与本仓库规范一致，避免和通用 rules 重复

Skill 结构约定

  • 每个 skill 一个独立目录，使用 kebab-case 命名
  • 每个 skill 目录必须包含 SKILL.md
  • 其余文件按需创建：
    • README.md
    • examples.md
    • scripts/
    • references/
    • assets/
    • tests/

SKILL.md 说明

SKILL.md 使用 YAML frontmatter 定义元信息，markdown 正文定义工作流。

frontmatter 支持字段

  • name: skill 名称（kebab-case）
  • description: 简短描述
  • argument-hint: 参数提示（可选）
  • user-invocable: 是否可由用户直接调用（true / false）
  • compatibility: 兼容性信息
  • context: 上下文配置
  • disable-model-invocation: 是否禁止模型自动调用（true / false）
  • license: 许可证
  • metadata: 额外元数据

Contributors

fengzai6

Issues