Guide

基于规范驱动与日志记录的轻量级人机协作项目开发与管理方案,包含 /guide load, /guide spec, /guide handoff, /guide test, /guide log 子命令。

260 stars 30 forksTesting & QA

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add cafe3310/public-agent-skills --skill guide
Manual install
git clone --depth 1 https://github.com/cafe3310/public-agent-skills.git /tmp/public-agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/public-agent-skills/skills/guide ~/.claude/skills/guide

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Skill: guide

## 1. 概述

文档驱动、日志记录的人机协作开发工作流。用户控制开发节奏,Agent 负责文档撰写、任务拆分、开发执行和日志记录。

## 2. 概念定义

以下为默认路径和命名约定。项目章程有特别约定时,以项目章程为准。

- `文档目录`: 默认为项目根目录下 `backlog/`,存放需求、设计、日志等文档
- `文档命名`: `YYYY-MM-DD-HH-mm-{类别}-{标题}.md`
- `规范目录`: 默认为项目根目录下 `specs/`,存放项目中长期生效的系统架构、数据契约、开发范式与全局禁忌规范
- `规范命名`: `{编号}-{标题}.md`
- `常用工作流`: 默认为项目根目录下 `workflows/`,存放项目中长期生效的工作流规范
- `常用工作流命名`: `{编号}-{标题}.md`
- `TODO 文件`: 默认项目根目录下 `TODO.md`
- `测试目录`: 默认项目根目录下 `tests/`
- `测试用例集命名`: `tests/{YYYY-MM-DD-HH-mm}-testsuite/`
- `测试用例命名`: `part{序号}-{模块}/case{序号}-{简述}.md`,在测试用例集内部

若无上述目录,可查看这些常见位置:

- `backlog/` 可能在 `docs/`
- `specs/` 可能在 `specifications` 或 `backlog/specs/`
- `workflows/` 可能在 `backlog/workflows/`
- `TODO.md` 可能在 `docs/TODO.md` 或 `backlog/TODO.md`

## 3. 文档类别和编写风格

除了后面的工作流之外,若用户要求,Agent 可以随时写文档。
文档命名中的 `{类别}` 按以下分类取值:

- `开发日志`: 开发过程、决策、问题及解决方式的记录。
- `需求`: 用户想要实现的功能或目标。仅含需求本身,不含实现细节。
- `设计`: 对即将实施任务的提前分析。子类别:`系统设计`、`架构设计`、`交互设计`、`需求设计`。
- `规范`: 定义广泛适用的规则、流程或标准。子类别:`架构规范`、`代码规范`、`流程规范`。
- `说明`: 对已完成技术实体的使用说明。子类别:`接口说明`、`模块说明`。
- `调研`: 对外部技术或资料的研究与对比分析。广泛搜索,记录来源,写出细节而非过度摘要。
- `参考`: 从外部摘录的原始资料。与调研的区别在于侧重原样引用而非主动分析。

文档的主要读者是未来的 Agent 和开发者。所有文档、过程日志与说明均保持精简、克制、平和、去形容词、去比喻化。无需冗长描述。记录人类决策、问题和修正方案。提供检索和理解所需的最小说明即可。

当用户指示或流程需要进行互联网调研时:广泛搜索相关资料;每找到一份资料,即记录为一份独立的调研文档,按命名约定命名;文档要记录来源,写出方案、观点、方法的细节,不要过度摘要。

## 4. Subcommands

本 Skill 包含以下子命令。这些子命令由人类按需指示触发与加载,Agent 在未收到人类对应子命令指示时无需主动提前加载其具体实现:

- `/guide load`: 探测项目环境,了解工作流和项目规约,加载 `TODO.md`(详见 `references/load.md`)。
Read the full skill on GitHub

Details

Skill name
guide
Path
skills/guide/SKILL.md
License
Apache-2.0
Repo updated
15 November 2026

FAQ

What does the Guide skill do?

基于规范驱动与日志记录的轻量级人机协作项目开发与管理方案,包含 /guide load, /guide spec, /guide handoff, /guide test, /guide log 子命令。

How do I install the Guide skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add cafe3310/public-agent-skills --skill guide. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Guide popular?

It lives in cafe3310/public-agent-skills, which has 260 GitHub stars and 30 forks.

Related skills

Skill Creator

260

cafe3310/public-agent-skills

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Skill & Plugin AuthoringIn 1 list30

Impeccable

260

cafe3310/public-agent-skills

Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Not for backend-only or non-UI tasks.

Frontend & DesignIn 2 lists30

Agent Browser

260

cafe3310/public-agent-skills

为 Agent 设计的自动化浏览器 CLI 工具,也能操作 Electron 桌面应用。当需要与网站交互(包括页面导航)时使用

AI, LLMs & Agents30

Polyhaven Hdri Showcase

260

cafe3310/public-agent-skills

Render the same product across multiple HDRI environments and output a comparison grid. Trigger when asked to compare lighting setups, test different environments, show product in multiple settings, or create an HDRI comparison.

Testing & QA30

Browser Testing

260

cafe3310/public-agent-skills

定义了使用浏览器开发者工具进行端到端(E2E)测试的工作流,测试用例以 Markdown 文件形式记录。

Testing & QA30

Pre Send QA

114

cognyai/claude-code-marketing-skills

Pre-flight QA for an email campaign — merge tags, broken links, spam triggers, compliance, mobile rendering — before you hit send

Testing & QAIn 3 lists16

Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.