Guide
基于规范驱动与日志记录的轻量级人机协作项目开发与管理方案,包含 /guide load, /guide spec, /guide handoff, /guide test, /guide log 子命令。
Install
npx skills add cafe3310/public-agent-skills --skill guidegit 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/guidePersonal 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`)。Details
- Skill name
guide- Repository
- cafe3310/public-agent-skills
- 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
260cafe3310/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.
Impeccable
260cafe3310/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.
Agent Browser
260cafe3310/public-agent-skills
为 Agent 设计的自动化浏览器 CLI 工具,也能操作 Electron 桌面应用。当需要与网站交互(包括页面导航)时使用
Polyhaven Hdri Showcase
260cafe3310/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.
Browser Testing
260cafe3310/public-agent-skills
定义了使用浏览器开发者工具进行端到端(E2E)测试的工作流,测试用例以 Markdown 文件形式记录。
Pre Send QA
114cognyai/claude-code-marketing-skills
Pre-flight QA for an email campaign — merge tags, broken links, spam triggers, compliance, mobile rendering — before you hit send
Browse the most popular Claude skills, all testing & qa skills, or write your own with the skills generator.