用途
adr-create 用于创建新的架构决策记录(Architecture Decision Record,ADR)。当出现需要记录的重大架构决策时使用,例如采用新技术、API 设计选择、数据模型变更、基础设施决策,或任何影响多个组件的横切关注点。
主要能力
- 自动确定下一个顺序编号:通过 Glob 匹配 docs/adr/ADR-*.md 并解析已有编号,得出下一个顺序 ID(ADR-001、ADR-002 等);若 docs/adr/ 目录不存在则创建。
- 标题 slug 化:将标题参数转换为小写、连字符分隔的 slug,例如 "Use PostgreSQL for persistence" 变为 use-postgresql-for-persistence。
- 按标准模板生成 ADR 文件,路径为 docs/adr/ADR-NNN-<slug>.md,模板包含:标题、Status(proposed)、Date(当天日期 YYYY-MM-DD)、Deciders、Tags、Context、Decision、Consequences(Positive / Negative / Neutral)、Links。
- 在 AgentDB 中登记:调用 mcp__plugin_ruflo-core_ruflo__agentdb_hierarchical-store,key 为 mem:ADR-NNN,tier 为 semantic,value 为 JSON 编码字符串,包含 id、title、status、date、file 字段。
- 查找相关 ADR:调用 mcp__plugin_ruflo-core_ruflo__memory_search,以标题为查询、命名空间为 adr-patterns 搜索相关决策;若找到匹配,则加入 Links 部分,并对每个关系调用 mcp__plugin_ruflo-core_ruflo__agentdb_causal-edge,sourceId 为 mem:ADR-NNN,targetId 为 mem:ADR-RELATED,relation 为 depends-on。
- 存储模式:调用 mcp__plugin_ruflo-core_ruflo__memory_store,在 adr-patterns 命名空间中以 ADR-NNN 为 key,存储标题与上下文,供未来语义搜索使用。
- 输出报告:报告创建的文件路径、ADR 编号以及找到的相关 ADR。
使用方式
该技能按固定步骤执行:先查找下一个编号,再对标题做 slug 化,然后写入 ADR 文件,接着存入 AgentDB,随后搜索相关 ADR 并建立因果边,再存储模式,最后输出报告。执行过程中会调用 ruflo 相关的 MCP 工具(agentdb_hierarchical-store、memory_search、agentdb_causal-edge、memory_store)。
适用场景
适用于团队需要系统化记录架构决策、并希望决策之间可追溯关联的工程环境,尤其是使用 ruflo 与 AgentDB 的工作流。
限制
资料未提供该技能的收费、价格、平台支持范围、具体安装命令或性能效果等信息,暂未提供。