用途:引导用户完成一次对话式访谈,为仓库产出完整、项目专属的 AGENTS.md 或 CLAUDE.md,规定 AI 编码代理在本仓库中的行为方式。该技能只负责“行为层”,项目背景、技术栈、架构、流程手册等内容应放入配套规范文档并链接引用,避免重复。
主要能力:检测当前目录是否位于 monorepo 包内并读取根级指令文件;检查 openspec/config.yml 或 openspec/config.yaml、ARCHITECTURE.md、CONSTRAINTS.md、EPISTEMIC-MAP.md、JARGON.md 等配套文档;识别本地文件状态并选择模式——无文件为 Mode 1 创建,空或近乎空白(约少于 10 行有效内容)为 Mode 1 覆盖确认,符合 ./assets/template.md 规范模板形态(两个及以上规范章节标题)为 Mode 3 刷新,有真实内容但结构无法识别为 Mode 2 导入。Mode 2 提供重构、追加、试运行三个分支;Mode 3 提供定向刷新与完整刷新两条路径。
使用方式:按工作流顺序执行,先建立进度清单,再依次完成状态检测、路径确认、执行单一模式剧本、必要时用并行子代理补齐行为缺口、最终编辑、展示带来源标注的完整预览并收集反馈、确认后写入、写入后质量检查、输出完成摘要。写入前必须展示预览并经用户确认。
限制:不得串行扫描代码库,发现阶段应使用并行子代理;不得跳过必要发现直接提问;不得遗漏模板必需章节,无法推断的字段保留章节并标记 <!-- TODO: fill in -->;monorepo 中包级文件不得重复根级指令;不得保留相互冲突的常驻规则,冲突按“用户确认答案、已确认仓库策略、有证据的推断、仍一致的既有文件内容、模板或技能默认值”的优先级解决,无法解决时在预览中暴露或使用 TODO;不得在未预览的情况下写入文件。具体安装命令与调用方式资料未提供。