Agent Skills › Stanshy/AgentHub › pitfall-record

pitfall-record

GitHub

将踩坑经验记录到 postmortem log。支持 build/runtime/deploy/test/process 分类，自动计算14天到期日，生成结构化 Markdown 条目并追加至日志文件，同时评估是否需更新通用规范。

.knowledge/company/skill-templates/pitfall-record/SKILL.md Stanshy/AgentHub

Trigger Scenarios

用户需要记录开发或运维中的踩坑经验用户输入 /pitfall-record 命令

Install

npx skills add Stanshy/AgentHub --skill pitfall-record -g -y

More Options

Non-standard path

npx skills add https://github.com/Stanshy/AgentHub/tree/main/.knowledge/company/skill-templates/pitfall-record -g -y

Use without installing

npx skills use Stanshy/AgentHub@pitfall-record

指定 Agent (Claude Code)

npx skills add Stanshy/AgentHub --skill pitfall-record -a claude-code -g -y

安装 repo 全部 skill

npx skills add Stanshy/AgentHub --all -g -y

预览 repo 内 skill

npx skills add Stanshy/AgentHub --list

SKILL.md

Frontmatter

{
    "name": "pitfall-record",
    "description": "Record a pitfall or lesson learned in the postmortem log",
    "allowed-tools": "Read, Edit, Glob"
}

踩坑紀錄

將踩坑經驗記錄到 postmortem log。

使用方式

/pitfall-record <category> <title>

參數

$0: 分類（build / runtime / deploy / test / process）
$1: 標題
$ARGUMENTS: 完整描述

執行步驟

讀取現有 postmortem log： !cat .knowledge/postmortem-log.md 2>/dev/null | tail -20 || echo "尚無踩坑紀錄"
計算到期日：紀錄日期 + 14 天，格式為 YYYY-MM-DD。
在 .knowledge/postmortem-log.md 末尾 append：

### {日期} — $1

| 項目 | 內容 |
|------|------|
| 分類 | $0 |
| 問題 | {問題描述} |
| 原因 | {根本原因} |
| 解法 | {解決方式} |
| 預防 | {未來如何避免} |
| 狀態 | open |
| 到期日 | {日期+14天, YYYY-MM-DD 格式} |