catalog/repos/adeonir--agent-skills.md

4.9 KiB
Raw Permalink Blame History

AI智能体技能集合

AI智能体 技能插件 Claude Code 工作流 开发工具

智能体技能集

个人收集的 AI 编程智能体技能库。每个技能封装了指令、参考资料和工作流,将智能体的能力扩展到默认范围之外。

什么是技能?

技能是封装好的指令包,用于教会 AI 智能体新的工作流和专业知识。可以将其理解为插件 —— 一个带有 YAML 前置元数据的 SKILL.md 文件告诉智能体何时激活Markdown 内容告诉它该做什么。支撑文件(参考资料、模板、脚本)按需加载,以将上下文占用控制在最小范围。

skill-name/
  SKILL.md              # 入口:前置元数据 + 指令
  references/           # 按需加载的详细文档
  CHANGELOG.md
  README.md

技能遵循 Agent Skills 开放标准,该标准起源于 Claude Code现已被所有主流 AI 编程智能体采用。

技能列表

技能 类别 描述
design-builder 设计 产品工程师设计流水线:提取文案和设计令牌、定义结构、预览并审批设计
debug-tools 开发 迭代调试:调查、修复、验证循环,支持模式比较和升级上报,含置信度评分
project-index 开发 生成项目上下文和深度代码库文档(含代码片段),在 .agents/ 中创建深度优先的文档
spec-driven 开发 规格驱动开发:规格说明、设计、任务拆分、实现,按复杂度自动调整规模,全流程可追溯
brainstorming 产品 结构化创意探索:发现上下文、发散思维、聚焦方向,可衔接 docs-writer、spec-driven、design-builder
docs-writer 产品 结构化文档生成PRD、简报、设计文档、TDD、RFC、ADR按文档类型引导式发现
epic-tracker 产品 交付生命周期管理:规划史诗、跟踪故事和缺陷、按版本分组,可衔接 spec-driven
product-naming 产品 调研并验证产品名称,含域名/社交媒体可用性检查及质量评分
git-helpers 工具 规范提交、置信度评分的代码审查、PR 摘要、拉取请求创建及分支生命周期管理
session-notes 工具 在 Obsidian 中创建笔记,支持项目、公司、挑战、亮点、日志、会话、决策和对话等类型

技能协作关系

flowchart TD
    BR[brainstorming] -->|方向| DW[docs-writer]
    BR -->|方向| PN[product-naming]
    BR -->|方向| DB[design-builder]
    PN -->|名称| DW
    PN -->|名称| DB
    DW -->|需求| ET[epic-tracker]
    DW -->|需求| DB[design-builder]
    ET -->|交接| SD[spec-driven]
    PI[project-index] -->|代码库文档| SD
    PI -->|规范约定| DB
    DB -->|审批设计| SD
    SD -->|提交/审查| GH[git-helpers]
    SD -->|新发现| PI
    GH -->|会话收尾| SN[session-notes]
    DT[debug-tools] -.->|升级上报| SD

完整项目流程

1. brainstorming     --> 探索创意,确定方向
2. product-naming    --> 调研并验证名称
3. docs-writer       --> 生成需求文档PRD、简报
4. epic-tracker      --> 规划史诗,跟踪故事和缺陷
5. project-index     --> 扫描代码库(已有项目时)
6. design-builder    --> 提取、结构化、预览、审批
7. spec-driven       --> 规格说明、设计、任务、实现
8. git-helpers       --> 提交、审查、PR、收尾
9. session-notes     --> 记录已完成的工作
10. debug-tools      --> 出现问题时使用

输出目录结构

技能将产物写入 .artifacts/,将参考上下文写入 .agents/

.agents/
├── project.md      # project-index项目上下文
├── codebase/       # project-index深度代码库分析
└── baselines/      # spec-driven功能区域行为基线

.artifacts/
├── features/       # spec-driven功能规格、设计、任务
├── quick/          # spec-driven快速模式任务
├── research/       # spec-driven调研缓存
├── epics/          # epic-tracker史诗、故事、缺陷、版本
├── brainstorm/     # brainstorming创意产物
├── docs/           # docs-writer + product-naming
└── design/         # design-buildercopy.yaml、design.json、变体

该目录默认被 gitignore但可以提交至版本库以支持团队协作。

安装

使用 Skills CLI 通过单条命令安装任意技能:

npx skills add adeonir/agent-skills

许可证

MIT