用途
该技能用于把用户零散、非结构化的想法、工作流反思和学习心得,转化为结构化的、可执行的 GitHub Issue 内容。它的目标不是堆积新 Issue,而是给现有 Issue 补充上下文,让反思在仓库中持续沉淀和复利。
适用时机
- 用户分享随机的想法或工作流反思,希望被“记录下来”。
- 用户说“把这些放进 issues”或“把这些过滤到 repos”。
- 会话结束后产生的学习心得,希望沉淀到仓库中。
- 用户希望把零散思考整理清楚(资料原文表述为让反思“straighten the twisted brain”)。
主要工作流程
阶段一:提炼主题 解析非结构化想法并提取核心主题,重点关注:已识别的问题与缺口、关于什么有效的洞察(资料称“secret sauce”)、提出的改进或后续步骤、问题的指标或证据、与现有工作的关联。
阶段二:映射到现有 Issue 资料强调:在创建任何新 Issue 之前,先搜索现有 Issue 全景。示例命令包括:
cd /mnt/local-analysis/workspace-hub
# Search by label categories
gh issue list --label cat:harness --state open --limit 10
gh issue list --label cat:platform --state open --limit 10
gh issue list --label domain:knowledge --state open --limit 10
# Search by keywords
gh issue search "keyword1 OR keyword2" --state open --limit 10
# View key issues
gh issue view $NUM 2>/dev/null
把每个提炼出的主题映射到最相关的现有 Issue。
阶段三:以评论形式引导(而非新建 Issue) 写入一个正文文件,并将其作为评论添加到现有 Issue:
cat > /tmp/comment_$NUM.md << 'EOF'
## Context Update (date)
[Distilled insight from user's reflection]
[Specific additions to acceptance criteria]
[Related issues to link]
[Quotes from user for context]
EOF
gh issue comment $NUM --body-file /tmp/comment_$NUM.md
如果没有任何现有 Issue 覆盖某一主题,则创建一个聚焦的新 Issue,并附上清晰的验收标准和引用。
阶段四:关闭不必要的 Issue 如果在意识到重复之前已经创建了 Issue:
gh issue comment $NUM --body "Closing as duplicate of #EXISTING - see context added there."
gh issue close $NUM
关键原则
- 引导优先于新建:始终优先增强现有 Issue。
- 引用用户原话:保留其原话作为上下文。
- 具体明确:补充可执行的验收标准,而不只是评论。
- 交叉链接:显式关联相关 Issue。
- 减少噪音:目标是提升信噪比,而非制造大量 Issue。
限制与未提供信息
资料未提供该技能的适用平台限制、是否收费或价格、依赖的具体运行环境(除示例中的路径与 gh 命令外)、安装方式,以及任何效果或成效数据,这些均暂未提供。