用途:在每个会话开始时先运行此技能,确保宿主项目的智能体上下文文件包含 swain 治理规则。技能是幂等的,每次会话都可运行,但只在首次使用时写入内容。
主要能力:检测智能体平台并定位上下文文件。Claude Code 使用项目根目录的 CLAUDE.md(默认,未检测到其他平台时使用);Cursor 使用 .cursor/rules/swain-governance.mdc(存在 .cursor/ 目录时)。随后检查治理规则是否已存在,命令为:grep -l "swain governance" CLAUDE.md .cursor/rules/swain-governance.mdc 2>/dev/null。若任一文件匹配,说明治理已安装,停止操作;若无匹配,则进入首次设置。
首次设置:将治理规则块注入对应上下文文件。Claude Code 追加到项目根目录的 CLAUDE.md,文件不存在则创建;Cursor 写入 .cursor/rules/swain-governance.mdc,必要时创建目录。注入的规则块包含技能路由、实施前协议和问题跟踪三部分:文档类工件(Vision、Journey、Epic、Story、Agent Spec、Spike、ADR、Persona、Runbook、Bug 及其支持文档)的创建、规划、编写、更新、流转或评审,始终调用 spec-management 技能;所有任务跟踪与执行进度使用 execution-tracking 技能,而非内置待办系统;任何 SPEC 工件(Epic、Story、Agent Spec、Spike)的实施在写代码前必须先有 execution-tracking 计划;问题跟踪使用 bd(beads),不使用 markdown TODO 或任务列表。
使用方式:会话开始时运行本技能,按提示完成检测与注入。注入后告知用户规则已安装到指定文件,可自定义规则,但需保留 <!-- swain governance --> 标记,以便后续会话检测。
限制:治理规则内容内嵌于技能中;若上游规则在未来 swain 版本中变更,需更新内嵌块并提升技能版本。希望获取更新规则的用户可删除上下文文件中的 <!-- swain governance --> 块后重新运行本技能。资料未提供其他平台支持、收费或价格信息。