211 lines
4.1 KiB
Markdown
211 lines
4.1 KiB
Markdown
# 项目结构初始化 实现计划
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** 为 claude-code-skills 仓库建立可扩展的项目结构（.gitignore、CLAUDE.md、skills/README.md、更新 README.md）
|
||
|
||
**Architecture:** 四个独立文件，无依赖关系，可按任意顺序创建。均为纯文本文件，无需测试。
|
||
|
||
**Tech Stack:** Markdown, Git
|
||
|
||
---
|
||
|
||
### Task 1: 创建 `.gitignore`
|
||
|
||
**Files:**
|
||
- Create: `.gitignore`
|
||
|
||
- [ ] **Step 1: 创建 .gitignore 文件**
|
||
|
||
```gitignore
|
||
# IDE
|
||
.vscode/
|
||
.idea/
|
||
*.swp
|
||
*.swo
|
||
|
||
# OS
|
||
.DS_Store
|
||
Thumbs.db
|
||
|
||
# Claude Code
|
||
.claude/backups/
|
||
```
|
||
|
||
- [ ] **Step 2: 提交**
|
||
|
||
```bash
|
||
git add .gitignore
|
||
git commit -m "添加 .gitignore"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 2: 创建 `skills/README.md`
|
||
|
||
**Files:**
|
||
- Create: `skills/README.md`
|
||
|
||
- [ ] **Step 1: 创建 skills 目录和 README.md**
|
||
|
||
```bash
|
||
mkdir -p skills
|
||
```
|
||
|
||
```markdown
|
||
# 技能列表
|
||
|
||
> 使用 Claude Code + DeepSeek v4
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
git clone https://git.geyoyo.top/glj/claude-code-skills.git ~/.claude/skills
|
||
```
|
||
|
||
## 可用技能
|
||
|
||
暂无技能，待添加。
|
||
```
|
||
|
||
- [ ] **Step 2: 提交**
|
||
|
||
```bash
|
||
git add skills/README.md
|
||
git commit -m "添加技能索引文件"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 3: 创建 `CLAUDE.md`
|
||
|
||
**Files:**
|
||
- Create: `CLAUDE.md`
|
||
|
||
- [ ] **Step 1: 创建 CLAUDE.md**
|
||
|
||
```markdown
|
||
# CLAUDE.md
|
||
|
||
本仓库为 Claude Code Skills 集合，托管于 Gitea（git.geyoyo.top/glj/claude-code-skills.git），为 Claude Code + DeepSeek v4 提供技能扩展。
|
||
|
||
## 仓库约定
|
||
|
||
- 文档和提交信息使用**简体中文**
|
||
- 技能目录命名使用 **kebab-case**（如 `code-review`、`spring-boot`）
|
||
- 保持扁平结构，不按领域分层
|
||
|
||
## 技能开发规范
|
||
|
||
### 目录结构
|
||
|
||
```
|
||
skills/<skill-name>/
|
||
└── SKILL.md
|
||
```
|
||
|
||
### SKILL.md 格式
|
||
|
||
```markdown
|
||
---
|
||
name: <kebab-case-name>
|
||
description: <一句话描述>
|
||
---
|
||
|
||
# <技能名称>
|
||
|
||
<技能内容>
|
||
```
|
||
|
||
- `name` 需与目录名一致
|
||
- `description` 用简体中文，一句话说明技能用途
|
||
|
||
### 添加技能流程
|
||
|
||
1. 在 `skills/` 下创建技能目录和 `SKILL.md`
|
||
2. 更新 `skills/README.md` 的技能列表
|
||
3. 提交并推送到远程
|
||
|
||
## 提交规范
|
||
|
||
- 提交信息用简体中文，格式：`<动词>: <简要描述>`，如 `添加 xxx 技能`
|
||
- 每次提交聚焦一个变更
|
||
```
|
||
|
||
- [ ] **Step 2: 提交**
|
||
|
||
```bash
|
||
git add CLAUDE.md
|
||
git commit -m "添加 CLAUDE.md 开发指南"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 4: 更新 `README.md`
|
||
|
||
**Files:**
|
||
- Modify: `README.md`
|
||
|
||
- [ ] **Step 1: 更新 README.md**
|
||
|
||
当前内容（仅供参考，不要直接复制整篇——在实际执行时读取最新内容后做精确替换）：
|
||
|
||
将幂等安装部分修正（原文 `claude-codec-skills` 有拼写错误），并在末尾添加指向 `skills/README.md` 的链接：
|
||
|
||
```markdown
|
||
# Claude Code Skills
|
||
|
||
Claude Code 技能集合，为 Claude Code + DeepSeek v4 提供专业领域的能力扩展。
|
||
|
||
## 快速开始
|
||
|
||
通过 Claude Code + DeepSeek v4 一键安装助手自动安装，或手动克隆：
|
||
|
||
```bash
|
||
git clone https://git.geyoyo.top/glj/claude-code-skills.git ~/.claude/skills
|
||
```
|
||
|
||
## 技能结构
|
||
|
||
每个技能是一个包含 `SKILL.md` 文件的子目录：
|
||
|
||
```
|
||
skills/
|
||
├── skill-name/
|
||
│ └── SKILL.md # 技能定义文件
|
||
└── README.md # 技能索引
|
||
```
|
||
|
||
## 可用技能
|
||
|
||
详见 [技能列表](skills/README.md)。
|
||
|
||
## 添加新技能
|
||
|
||
1. 在此仓库中创建新目录
|
||
2. 添加 `SKILL.md` 文件
|
||
3. 更新 `skills/README.md`
|
||
4. 提交并推送
|
||
|
||
更多详情见 [Claude Code Skills 文档](https://docs.anthropic.com/en/docs/claude-code/skills)。
|
||
```
|
||
|
||
**说明:** 原文 `claude-codec-skills` 有拼写错误（多了一个 c），修正为 `claude-code-skills`；目录结构中增加 `README.md` 节点；新增"可用技能"小节链接到技能索引；安装路径统一为 Linux/macOS 风格。
|
||
|
||
- [ ] **Step 2: 提交**
|
||
|
||
```bash
|
||
git add README.md
|
||
git commit -m "完善 README.md：修正链接、添加技能索引引用"
|
||
```
|
||
|
||
---
|
||
|
||
### Task 5: 最终推送
|
||
|
||
- [ ] **Step 1: 推送到远程**
|
||
|
||
```bash
|
||
git push origin master
|
||
```
|