用途:编写并维护项目的适配配置 .aidoc/profile.yaml,这是 SDD 技能据以编写和审计产物的运行时输入,让项目在采用框架默认值的同时做受控偏离,而无需分叉框架。属于跨切面工具,先于并影响各层技能。
适用场景:项目需要偏离框架默认值,例如运行更精简的层集合、开关某可选章节、收紧审计门槛或使用团队术语;引入带开发者个人风格的既有项目;审阅或刷新已有 .aidoc/profile.yaml。不适用:编写或审计具体产物(用各层技能);把本地适配上升为框架内容(用 knowledge-extractor)。
主要能力与做法:
- 解析作用域。项目配置 .aidoc/profile.yaml 为运行时输入并纳入版本控制,保证 CI 中审计可复现;用户全局种子 ~/.aidoc/profile.yaml 为可选,不在运行时读取,仅在编写时合并进项目配置。优先级为框架默认 < 用户全局种子 < 项目回答。
- 推断起点。复用 doc-flow 的上下文扫描来提出 active_layers、识别可选章节与术语候选,不重复扫描。
- 访谈四个 v1 旋钮:active_layers(仅可停用可跳过集,如 BDD、ADR,强制层保留)、section_toggles(仅模板声明的可选章节)、audit_threshold(只可上调,须不低于该层框架默认)、glossary(默认词到项目词的映射,仅作用于生成的文本)。
- 依 ADAPTATION_SURFACE.yaml 校验:丢弃不在 knobs 中的键;拒绝停用强制层并对可跳过层套用 cascade_rule;拒绝写入低于默认的审计门槛;section_toggles 仅保留模板声明的可选章节。
- 按优先级合并并写出 .aidoc/profile.yaml,包含与 surface 一致的 schema_version,提交该文件。示例结构含 schema_version、active_layers、section_toggles、audit_threshold、glossary。
- 交接:报告变更并引导至 doc-flow;此后各适配技能读取该配置,project-init 与 project-adopt 仅搭建活跃层。
限制:框架不提供运行时代码,本技能仅作为配置编写者;只写封闭面中存在的键,其余静默丢弃;配置须提交以保持可复现。具体价格、平台等信息暂未提供。