mcpField
B
btw

btw

github.com/ww-w-ai生产力60664 次安装4 周前更新
代码仓库

关于 btw

btw 是用于收集和整理工作改进建议的技能，可记录建议、分析候选技能并将条目推进到 skill-create 流程。它还可按类别统计，并读取 PDCA 阶段及团队会话上下文。

主要功能

  1. 01记录并分类建议
  2. 02列出建议及其状态
  3. 03分析技能候选项
  4. 04将建议推进至技能创建
  5. 05查看统计与关键词
  6. 06关联 PDCA 和团队上下文

适用场景

  1. 01随工作进展记录自动化想法
  2. 02从待处理建议中归纳技能需求
  3. 03在团队阶段转换时查看建议摘要

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill btw

安装后在 Claude Code 中输入/btw确认已加载。

详细介绍

/btw - 随手建议收集器

在工作期间立即记录和管理“这个做成技能会不错”“最好把这个模式自动化”等改进建议的工具。

Commands

/btw {suggestion} - 记录建议
  1. 读取 .bkit/btw-suggestions.json（如果不存在则创建）
  2. 生成下一个 ID：btw-NNN（补零，按顺序递增）
  3. 创建建议条目： 
    {
  "id": "btw-001",
  "timestamp": "ISO-8601",
  "suggestion": "{user input}",
  "context": {
    "file": "{current working file if identifiable}",
    "pdcaPhase": "{current PDCA phase from getPdcaStatusView() or null}",
    "feature": "{current feature or null}"
  },
  "category": "auto-detect",
  "status": "pending",
  "promotedTo": null,
  "priority": null,
  "teamContext": {
    "isTeamSession": false,
    "phase": "{PDCA phase or null}",
    "role": "{teammate role that discovered this, or 'user'}",
    "pattern": "{orchestration pattern or null}"
  }
}
  4. 根据建议文本自动检测类别：
    • skill-request：提及“skill”“스킬”“자동화”“automate”
    • bug-pattern：提及“bug”“버그”“오류”“error”“fix”
    • improvement：提及“개선”“improve”“better”“refactor”
    • documentation：提及“문서”“doc”“설명”“explain”
    • general：默认类别
  5. 更新 stats.total 计数
  6. 回复：“已记录 btw-{NNN}：{截断后的建议}。使用 /btw list 查看全部建议。”
/btw list - 列出所有建议
  1. 读取 .bkit/btw-suggestions.json
  2. 显示表格： 
    ID       | Status   | Category       | Suggestion (truncated)
---------|----------|----------------|----------------------
btw-001  | pending  | skill-request  | @Flow 모델에서 옵션 목록을 자동...
btw-002  | promoted | improvement    | DataProxy 패턴에 검증 로직을...
  3. 显示摘要：总计：N | 待处理：N | 已提升：N | 已忽略：N
/btw analyze - 分析可作为技能候选的建议
  1. 从 .bkit/btw-suggestions.json 读取所有待处理建议
  2. 按类别分组并查找模式：
    • 将相似建议聚类（关键词重叠）
    • 统计相似主题的出现频率
    • 确定哪些建议对应现有 bkit 技能，哪些需要新技能
  3. 对于每个技能候选：
    • 估算技能分类：工作流或能力
    • 建议技能名称和描述
    • 引用来源建议 ID
  4. 输出分析结果： 
    Skill Candidates from /btw Analysis
=====================================

1. [NEW SKILL] hunikflow-validation (capability)
   Based on: btw-001, btw-005, btw-008
   Frequency: 3 mentions
   Description: Validation pattern guide for @Flow entities

2. [EXISTING SKILL ENHANCEMENT] code-review
   Based on: btw-003
   Suggestion: Add DataProxy-specific review rules
  5. 将分析时间戳保存到 stats.lastAnalyzed
/btw promote {id} - 将建议提升为技能创建任务
  1. 在 .bkit/btw-suggestions.json 中按 ID 查找建议
  2. 验证状态为 "pending"（已提升或已忽略的建议无法提升）
  3. 更新建议：
    • status：“promoted”
    • promotedTo：技能名称（根据建议生成）
  4. 使用建议中的上下文触发 skill-create 工作流：
    • 将建议文本作为技能描述的起始内容传递
    • 将上下文（文件、功能）作为项目上下文传递
  5. 回复：“已将 btw-{id} 提升至 skill-create 流程。运行 /skill-create 继续。”
/btw stats - 显示统计信息
  1. 读取 .bkit/btw-suggestions.json
  2. 计算并显示： 
    /btw Statistics
===============
Total suggestions: 12
By status: pending=8, promoted=3, dismissed=1
By category: skill-request=5, improvement=4, bug-pattern=2, general=1
Promotion rate: 25.0%
Last analyzed: 2026-03-13T10:00:00Z
Top keywords: @Flow(3), DataProxy(2), validation(2)

数据文件：.bkit/btw-suggestions.json

如果文件不存在，则使用以下结构初始化：

{
  "version": "1.0",
  "suggestions": [],
  "stats": {
    "total": 0,
    "promoted": 0,
    "dismissed": 0,
    "lastAnalyzed": null
  }
}

类别自动检测规则

模式类别
skill, 스킬, automate, 자동화, command, 명령skill-request
bug, 버그, error, 오류, fix, 수정bug-pattern
improve, 개선, better, refactor, 리팩토링, optimizeimprovement
doc, 문서, explain, 설명, readme, guidedocumentation
（默认）general

集成点

  • PDCA 上下文：通过 getPdcaStatusView() 读取阶段和功能 （lib/pdca/status.js），该方法仅涵盖有文档证据的阶段。 .bkit/state/memory.json — 迁移后的 .bkit-memory.json — 保存 9 阶段流水线状态，而非 PDCA 阶段。
  • skill-create：/btw promote 会触发 skill-create 工作流
  • skill-needs-extractor：/btw analyze 的结果会用于差距分析
  • CTO 团队：阶段转换时会触发 btw 摘要（见下文）

CTO 团队集成

在 CTO 团队会话（/pdca team）期间使用 /btw 时：

自动检测
  • 通过 .bkit/runtime/agent-state.json 检查团队会话是否处于活动状态
  • 如果处于活动状态：设置 teamContext.isTeamSession = true，并填充阶段/角色/模式
  • 如果未处于活动状态：设置 teamContext.isTeamSession = false（默认行为）
阶段转换钩子

CTO Lead 会在每次阶段转换时自动读取 btw-suggestions.json：

  • 0 项待处理：静默跳过（无输出，不占用回合）
  • 1 项或更多待处理：用 1–2 个回合简要摘要（最多 3 项，包含类别计数）
  • CTO 不会自动提升建议——由用户通过 /btw promote {id} 决定
会话结束

cto-stop.js 钩子会在会话结束时输出 btw 统计信息：

  • 会话期间收集的建议总数
  • 类别细分
  • 提升率
teamContext 字段

在团队会话期间记录每条建议时添加：

"teamContext": {
  "isTeamSession": true,
  "phase": "do",
  "role": "user",
  "pattern": "swarm"
}

这使 /btw analyze 能够按 PDCA 阶段对建议进行分组，并识别各阶段特有的模式。

评论

支持 Markdown