Fix Authentication Bug【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beadsTypebugPriority1Labelsauth, backend, urgent, needs-reviewDescriptionUsers cant log in after recent deployment.bash bd create -f issue.md # 创建包含全部四个标签的 issue最佳实践1. 尽早建立约定把团队的标签分类法写进 README 或 CONTRIBUTING# 加入项目 README 或 CONTRIBUTING.md - 使用小写、连字符分隔如 good-first-issue - 团队标签加前缀如 team-infra、team-product - 使用一致的大小标签small、medium、large2. 不要滥用标签标签虽灵活但过多会造成混乱。建议5-10 个核心技术标签backend、frontend、api等每个项目 3-5 个领域标签标准流程标签needs-review、needs-tests按需使用发布标签3. 定期清理未用标签bd label list-all # 从 issue 上移除过时的标签4. 标签用于过滤不用于搜索标签服务于分类而非自由文本搜索✅ 好的例子backend、auth、urgent❌ 坏的例子fix-the-login-bug、john-asked-for-this5. 与依赖结合标签 依赖 强大的组织能力# 带标签子任务的 epic bd create Auth system rewrite -t epic -p 1 -l auth,v2.0 bd create Implement JWT -t task -p 1 -l auth,backend --deps parent-child:bd-42 bd create Update login UI -t task -p 1 -l auth,frontend --deps parent-child:bd-42 # 找出所有 v2.0 的 auth 工作 bd list --label auth,v2.0AI Agent 使用标签对管理复杂工作流的 AI Agent 尤其有用# 自动标记发现的工作 bd create Found TODO in auth.go -t task -p 2 -l auto-generated,technical-debt # 过滤出待 Agent 审查的项 bd list --label needs-review --status in_progress --json # 跟踪自动化元数据 bd label add bd-42 ai-generated bd label add bd-42 needs-human-reviewAgent 工作流示例# Agent 在重构中发现 issue bd create Extract validateToken function -t chore -p 2 \ -l technical-debt,backend,auth,small \ --deps discovered-from:bd-10 # Agent 标记工作待审查 bd update bd-42 --claim # ... agent 干活 ... bd label add bd-42 needs-review bd label add bd-42 ai-generated # 人类审查并批准 bd label remove bd-42 needs-review bd label add bd-42 approved bd close bd-42进阶模式一标签作为状态缓存标签可以缓存操作状态以支持快速查询让 Beads 同时跟踪不可变历史事件与当前状态标签。约定维度:值示例patrol:muted/patrol:active—— patrol 抑制状态mode:degraded/mode:normal—— 操作模式status:idle/status:working—— worker 状态health:healthy/health:failing—— 组件健康状态实现步骤创建事件 bead完整上下文、不可变历史更新角色 bead 的标签当前状态缓存# 事件完整记录发生了什么、为什么 bd create Muted patrol: user requested during debugging -t event \ -l event-type:patrol-muted,actor:observer,reason:user-request # 状态更新角色 bead 的标签以反映当前状态 bd label remove beads/observer patrol:active bd label add beads/observer patrol:muted核心原则事件是真相来源source of truth标签是供快速查询的缓存。为什么用这个模式免事件扫描的快速查询# 不用标签缓存扫描全部事件找最新 patrol 状态慢且脆弱 bd list --type event | grep patrol | tail -1 # 用标签缓存直接查询即时 bd show beads/observer | grep patrol:历史完整保留# patrol 何时被静音为什么谁做的 bd list --label event-type:patrol-muted --type event状态可恢复# 若标签损坏从事件重建 bd list --type event --label event-type:patrol-muted | tail -1 # 然后重新应用标签常见状态维度维度取值用途patrol:active、mutedPatrol 周期抑制mode:normal、degraded、maintenance操作模式status:idle、working、blockedWorker 活动health:healthy、warning、failing组件健康lock:unlocked、locked独占访问控制状态转换改状态标签前永远先创建事件# 带审计轨迹转换状态的函数 transition_state() { local role$1 local dimension$2 local old_value$3 local new_value$4 local reason$5 # 记录转换 bd create State change: $dimension $old_value → $new_value -t event \ -l event-type:state-change,dimension:$dimension,from:$old_value,to:$new_value # 更新缓存 bd label remove $role $dimension:$old_value bd label add $role $dimension:$new_value } # 用法 transition_state beads/observer patrol active muted User debugging session查询状态# 某角色的当前状态 bd label list beads/observer | grep : # 处于特定状态的所有角色 bd list --label patrol:muted # 不在预期状态的角色 bd list --label-any mode:degraded,health:failing # 状态变更历史 bd list --type event --label event-type:state-change最佳实践使用带命名空间的维度—— 有歧义时加角色类型前缀保持取值集合小而精—— 每个维度 2-4 个值文档化合法取值—— 在角色文档中列出允许的值永远先创建事件—— 绝不无历史地更新标签把标签视为可抛弃的—— 损坏时从事件重建未来的辅助命令该模式启发了一些辅助命令见 bd-7l67# 查询当前状态 bd state beads/observer patrol # → muted # 带自动事件创建的转换 bd set-state beads/observer patrolactive --reason Debugging complete在辅助命令落地前请使用上面的手动模式。bd set-state的完整命令参考见 docs/cli-reference/set-state.md。进阶模式二编排系统中的操作状态角色 bead 状态缓存对编排系统而言标签可以缓存角色 bead代表 Agent 或系统组件的 issue的当前操作状态无需扫描事件历史即可快速查询状态。约定维度:值使用冒号分隔、维度前缀 值后缀的标签patrol:muted patrol:active mode:degraded mode:normal status:idle status:working health:healthy health:failing模式流程创建事件 bead携带完整上下文不可变、可审计更新角色 bead 的标签反映当前状态快速查找# 1. 记录事件真相来源 bd create Muted patrol for agent-abc -t event \ --parent agent-abc \ -d Reason: investigating stuck worker. Expected duration: 30m # 2. 更新缓存的状态标签 bd label remove agent-abc patrol:active bd label add agent-abc patrol:muted为什么事件是真相标签是缓存方案仅事件标签作缓存查询当前状态扫描全部事件找最新bd list --label patrol:muted查询状态历史自然所有事件都在查询事件审计轨迹完整完整事件仍然存在性能O(n) 事件O(1) 标签查找该模式两者兼得事件提供完整历史标签提供快速查询。示例Agent 角色状态# 为 Agent 创建角色 bead bd create witness-alpha -t role -l patrol:active,mode:normal,health:healthy # Agent 进入降级模式 bd create Degraded: high error rate -t event --parent witness-alpha \ -d Error rate exceeded 5%. Reducing poll frequency. bd label remove witness-alpha mode:normal bd label add witness-alpha mode:degraded # 查询当前状态 bd list --label mode:degraded --type role # 所有降级角色 # Agent 恢复 bd create Recovered: error rate normal -t event --parent witness-alpha bd label remove witness-alpha mode:degraded bd label add witness-alpha mode:normal常见维度维度取值用途patrolactive、muted、suspendedAgent patrol 周期modenormal、degraded、maintenance操作模式statusidle、working、blocked工作状态healthhealthy、warning、failing健康检查synccurrent、stale、syncing同步状态最佳实践永远先创建事件—— 标签是缓存事件是真相先移除旧值再加新值—— 避免出现dimension:value1与dimension:value2冲突使用一致的维度名—— 尽早建立团队约定保持维度正交—— patrol 与 mode 是相互独立的关注点查询状态# 找出所有被静音的 patrol bd list --label patrol:muted # 找出正常模式下健康的 Agent bd list --label health:healthy,mode:normal # 找出任何不健康的 Agent bd list --label-any health:warning,health:failing # 获取特定角色的状态 bd label list witness-alpha # 输出: patrol:active, mode:normal, health:healthy辅助命令为方便起见可使用这些辅助命令# 查询特定维度 bd state witness-alpha patrol # 输出: active # 列出所有状态维度 bd state list witness-alpha # 输出: # patrol: active # mode: normal # health: healthy # 设置状态原子地创建事件 更新标签 bd set-state witness-alpha patrolmuted --reason Investigating issueset-state命令会原子地完成三步① 携带 reason 创建事件 bead真相来源② 若存在旧维度标签则移除③ 添加新的dimension:value标签缓存。更多高级模式组件矩阵跨多个维度跟踪 issue# backend auth 高优先级 bd list --label backend,auth --priority 1 # 任何小的前端工作 bd list --label-any frontend,ui --label small # 跨所有组件的关键 issue bd list --priority 0 --label-any backend,frontend,infrastructure迭代规划# 为迭代标记 issue for id in bd-42 bd-43 bd-44 bd-45; do bd label add $id sprint-12 done # 跟踪迭代进度 bd list --label sprint-12 --status closed # 速率 bd list --label sprint-12 --status open # 剩余 bd stats | grep In Progress # 当前 WIP技术债跟踪# 标记债务 bd create Refactor legacy parser -t chore -p 3 -l technical-debt,large # 找出要处理的债务 bd list --label technical-debt --label small bd list --label technical-debt --priority 1 # 高优先级债务破坏性变更协调# 标识破坏性变更 bd label add bd-42 breaking-change bd label add bd-42 v2.0 # 找出下一个大版本的所有破坏性变更 bd list --label breaking-change,v2.0 # 确保它们都有文档 bd list --label breaking-change --label needs-docs故障排查标签不显示在列表中标签需要显式获取bd list的人类可读输出不显示标签仅 JSON 有。这是有意的设计——列表的文本渲染通过SkipCounts跳过聚合开销cmd/bd/list.go#L287-L291标签则按需通过bd label list或bd show --json获取。# 在 JSON 中查看标签 bd list --json | jq .[] | {id, labels} # 查看特定 issue 的标签 bd show bd-42 --json | jq .labels bd label list bd-42标签过滤不生效检查标签名是否精确匹配大小写敏感# 这是两个不同的标签 bd label add bd-42 Backend # 大写 B bd list --label backend # 匹配不到 # 列出所有标签核对确切名称 bd label list-all标签同步问题标签存储在 Dolt 数据库中。若标签看起来不同步# 从 Dolt 远端拉取 bd dolt pull # 或运行 doctor 诊断 bd doctor【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考