Communitygithub.com

curiositech/windags-skills

为需要检测规范、选择内化哪些承诺并通过比较后果来解决冲突的自主智能体应用标准化BDI推理。当义务、禁令或政策在自主系统中发生冲突时使用。不适用于简单的固定优先级规则、纯约束满足或不存在真正规范性冲突的领域。

windags-skills 是什么?

该技能(curiositech/windags-skills)为基于BDI(信念-愿望-意图)架构的自主智能体提供规范性推理能力。核心创新在于将规范的“识别”与“内化”相分离,允许智能体在知晓规范的前提下有意识地选择违反,并给出可解释的原因。它定义了三种一致性状态(强不一致、弱一致、强一致),并采用“后果排序”法解决冲突:生成最大不冲突子集,比较每个子集的最坏后果,选择最不坏的方案。该技能支持Claude Code、Cursor、Codex等主流AI代理平台,通过清晰的决策流程图、抗模式识别和丰富的参考文件(如规范分离、一致性类型、冲突解决等)提供工程指导。它特别适用于多规则冲突场景,如隐私与个性化、机器人伦理困境等,能有效避免固定优先级、隐藏违规等常见失败模式。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/a-normative-extension-for-the-bdi-agent

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

规范性BDI智能体架构

当智能体需要感知多种规范、决定采纳哪些规范并解释为什么故意违反比替代方案更好时,请使用此技能。

使用时机

  • 多个规则、义务、禁令或利益相关者需求无法同时满足。
  • 智能体需要区分“知道某个规范存在”和“实际选择遵守它”。
  • 系统需要证明为什么违反一条规则以满足另一项更高风险的承诺。
  • 你需要一种基于后果的替代方案,取代脆弱的硬编码优先级列表。
  • BDI架构需要一种有原则的方式来整合规范性推理,而又不将规范变成绝对覆盖。

不适用边界

此技能不是以下场景的主要工具:

  • 固定优先级层次结构,其中正确的优先级顺序不会随上下文改变。
  • 纯约束满足,任何满足解的方案都足够好,且规范违反不在考虑范围内。
  • 要求字面意义上不得违反的监管或伦理环境,无论后果如何。
  • 不维护信念、承诺或故意违反解释的玩具规则引擎。

核心心智模型

识别不等于内化

将抽象规范库与规范实例库分开。智能体可以在不采纳规范的情况下检测到它。这种分离允许有意识、可解释的不合规,而不是偶然的忽视。

三种一致性状态

  • 强不一致:没有计划能同时满足两个承诺。
  • 弱一致:某些计划可行,但未来的灵活性会缩小。
  • 强一致:所有相关计划仍然兼容。

弱一致的情况是大多数实际设计判断所在之处。

后果排序

当规范冲突时,通过最差下游后果比较承诺的连贯捆绑。重点不是最大化平均好处;而是在不相容的未来中选择最不坏的最坏情况。

规范作为假设性愿望

采纳的义务和禁令成为BDI机制内部的可废止压力,而不是一个独立的覆盖系统。这使规范推理保持在与普通目标追求相同的 deliberative 循环中。

决策点

参见 diagrams/01_flowchart_decision-points.md 中的采纳和冲突流程。

flowchart TD
  A[检测到规范] --> B{基于当前信念可实例化?}
  B -->|否| C[保持抽象并监控]
  B -->|是| D[检查一致性]
  D -->|强不一致| E[按最坏后果比较冲突捆绑]
  D -->|弱一致| F[评估灵活性成本]
  D -->|强一致| G[采纳规范]
  E --> H[选择最不坏的最坏情况]
  F --> I{采纳仍然值得?}
  I -->|是| G
  I -->|否| J[拒绝或推迟]
  H --> G

1. 决定是否采纳规范

  • 如果新规范与当前承诺强不一致,采纳需要放弃或修改其他承诺。
  • 如果弱一致,在采纳前明确灵活性成本。
  • 如果强一致,采纳风险低,通常应自动进行。

2. 决定如何解决冲突

  • 生成最大不冲突子集,而不是孤立地一对一比较规范。
  • 为每个子集制定计划,识别每个未来中的最坏后果。
  • 选择最坏情况最不坏的那个子集,然后记录选择该违反的理由。

3. 决定何时实例化抽象规范

  • 仅在当前信念能绑定变量并满足激活条件时实例化。
  • 当知识不完全时,使未解决的规范保持可见,而不是假装它们不适用。
  • 在有意义的信念更新后重新评估待处理的抽象规范。

失败模式

1. 过度采纳死锁

症状: 智能体不断内化规范,直到没有可行行动剩余。 检测规则: 行动空间缩小速度快于冲突解决速度。 恢复: 在任何一个新规范进入规范实例库之前,强制进行一致性审查。

2. 隐藏违规

症状: 智能体违反规范,但不能说明它选择这样做。 检测规则: 事后解释省略了被拒绝的规范,或将违规视为从未发生。 恢复: 持久化被拒绝但仍被识别的规范,并记录获胜的后果比较。

3. 二元一致性崩溃

症状: 采纳逻辑将每个规范视为完全兼容或完全不可能。 检测规则: 弱一致性从未出现在架构或日志中。 恢复: 添加显式的弱一致性分支,并直接建模灵活性损失。

4. 固定优先级脆弱性

症状: 相同的全局优先级栈在边缘情况下产生明显错误的选择。 检测规则: 冲突结果仅在优先级表改变时改变,而从不因后果改变。 恢复: 从刚性优先级转向子集生成加后果排序。

5. 规范侧信道架构

症状: 规范处理位于一个独立的执行模块中,在执行后期覆盖BDI deliberative。 检测规则: 规范逻辑无法用信念、愿望和意图来解释。 恢复: 将采纳的规范转化为内部 deliberative 压力,并通过主架构路由。

示例

示例1:隐私 vs 个性化

一个服务智能体知道一个禁止直接使用客户级数据的规范,以及一个改善用户体验的义务。系统发现弱一致:聚合行为摘要保留了大部分个性化,同时限制了隐私损害。该技能保持两个规范可见,只实例化聚合安全的义务,并记录为什么拒绝了直接数据使用。

示例2:机器人与婴儿

一个看护机器人面临一个保持婴儿存活的义务和一个禁止对人类产生感情的禁令。没有计划能满足两者。该技能生成两个连贯子集,比较最坏后果,并故意违反设计禁令,因为死亡比禁止的感情更糟糕。违反是明确且可报告的。

质量门禁

  • 架构区分检测到的规范和采纳的规范。
  • 一致性检查包括强不一致、弱一致和强一致。
  • 冲突解决比较连贯子集,而不仅仅孤立地比较规范。
  • 选择的违规记录有显式的后果比较。
  • 当信念基础不完整时,抽象规范可以保持待处理状态。

参考文件

文件加载时机
references/separation-of-norm-recognition-and-norm-internalization.md设计ANB vs NIB边界时
references/three-types-of-consistency-for-norm-adoption.md实现采纳检查和灵活性成本逻辑时
references/normative-conflict-resolution-through-consequence-ranking.md构建或审查基于后果的冲突解决时
references/norm-instantiation-through-belief-grounding.md将抽象规范实例化为具体上下文时
references/maximal-non-conflicting-subsets-for-action-selection.md计算冲突下的连贯选项束时
references/desire-internalization-as-norm-adoption-mechanism.md将规范集成到BDI愿望和意图处理中时

反模式

  • 硬编码单一优先级顺序并称之为“伦理”。
  • 自动采纳每个检测到的规范,仅在执行时发现矛盾。
  • 将弱一致视为与强一致相同。
  • 基于平均效用比较违规,同时忽略灾难性最坏情况。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

相关技能