OpenSkillIndex← back to search
claude-code

ClaWiser project-skill-pairing

install
source · Clone the upstream repo
git clone https://github.com/MattWenJun/ClaWiser
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/MattWenJun/ClaWiser "$T" && mkdir -p ~/.claude/skills && cp -r "$T/assets/project-skill-pairing" ~/.claude/skills/mattwenjun-clawiser-project-skill-pairing && rm -rf "$T"
manifest: assets/project-skill-pairing/SKILL.md
tags
#project-management#skill-management#clawiser
source content

Project-Skill Pairing — 项目与 Skill 结对

每个 Skill 必须有项目归属。每个项目必须知道自己关联哪些 Skill。

Skill 不是孤零零的 prompt 文件。它从项目中长出来，在项目中演化，它为什么长成这样、改过几次、在哪验证过，都要有地方可追。

核心规则

Skill → 项目（Skill 必须有归属）

新建 Skill 后，二选一：

  1. 独立 Skill（通用工具，如 hdd、save-game） → 建同名 project：

    memory/projects/<skill-name>/HANDOFF.md

  2. 项目衍生 Skill（从某个项目中长出来的） → 在该项目目录下建 symlink 指向 skill

项目 → Skill（项目要知道自己的 Skill）

只链接直接关联的 skill，不链接通用工具。

判断标准：如果这个 skill 不存在，这个项目就无法正常运行或理解 → 链接。否则不链。

  • ✅ 链接：项目产出的 skill、项目专属的工作流 skill
  • ❌ 不链接：hdd、save-game、load-game 等所有项目都用的通用 skill

AGENTS.md 分工

  • AGENTS.md：只放路由规则和元规则（"新 skill 必须有项目归属"）
  • SKILL.md：放具体方法（怎么做、步骤、参考）
  • 不要把具体方法堆进 AGENTS.md

项目结构（三层分级）

Tier 1: 轻量级

一次性修复、探索性工作、已完成的小任务。

memory/projects/<name>/
└── <name>.md              # 单文件：背景 + 结论

判断：一两个 session 完成，不会持续迭代。

Tier 2: 标准

跨天/跨周、有明确阶段、持续迭代的项目。

memory/projects/<name>/
├── HANDOFF.md             # 当前状态 + 下一步（必须）
├── product-plan.md        # 目标 + 架构（有产品目标时）
└── skills/                # 直接关联 skills 的 symlink

判断：多 session 工作，有阶段划分，预期继续迭代。

Tier 3: 复杂

大型系统、多子系统、长期维护（>1 月）。

memory/projects/<name>/
├── README.md              # 入口导航（文件地图 + 快速链接）
├── product-plan.md        # 产品计划
├── HANDOFF.md             # 交接文档
├── dev-log.md             # 开发日志（决策历史）
└── skills/                # 直接关联 skills 的 symlink

判断：有代码产出、多子系统、预期维护 > 1 月。

新建项目流程

1. 确定名称和层级

  • 小写字母 + 连字符（如 
    follow-up-tracker
    ）
  • 检查 
    memory/projects/
    无同名/相似项目
  • 根据判断标准选 Tier

2. 创建文件夹 + 文档

mkdir -p memory/projects/<name>

3. HANDOFF.md 模板（Tier 2+）

# <项目名> 交接文档

> 最后更新：YYYY-MM-DD HH:MM | v1
> 下次 agent 读这一个文件就够了

## 🎯 项目目标
## 📍 当前进展
## ➡️ 下一步
## 关键经验 & 铁律
## 架构

Tier 升级

项目可以从低 Tier 升到高 Tier，补齐文档即可。

  • Tier 1 → 2：项目开始跨 session 迭代
  • Tier 2 → 3：代码规模增长、多人/多 agent 协作

查缺补漏

对已有项目按其 Tier 检查：

Tier 1：

  • <name>.md
    存在且有背景说明

Tier 2：

  • HANDOFF.md 存在且结构完整（目标/进展/下一步/架构/铁律）
  • skills/ 目录存在且 symlink 指向直接关联的 skills
  • AGENTS.md 里相关路由规则已同步

Tier 3（在 Tier 2 基础上）：

  • README.md 存在（入口导航 + 文件结构图）
  • dev-log.md 存在（至少记录关键决策）

依赖关系

  • 前置：
    memory-deposit
    （项目文档存在 memory/ 下，需要 git 版本管理）
  • 被依赖：
    save-game
    / 
    load-game
    （操作项目的 HANDOFF.md）