用途:帮助用户建立项目专属的文档产物规范,涵盖路径、命名与生命周期,使 capture-work-items、brainstorm-design、assess-doc-readiness 等其他技能能遵循项目自身的规范。
主要能力:扫描项目根目录与 docs/ 结构,识别 backlog、design、adr、calibration 等已有路径及命名、front-matter 约定;通过对话确认各产物类型的 path_pattern 与命名;生成人类可读的 docs/ARTIFACT_NORMS.md,并可按用户要求生成机器可读的 .ai-cortex/artifact-norms.yaml,需符合 spec/artifact-norms-schema.md。
使用方式:以项目路径(默认当前工作区根目录)为输入,可选起始点 ai-cortex、template 或 blank。流程为扫描结构、选择起始点、确认路径、写入并确认;写入前需展示摘要并取得用户明确批准。
适用场景:新项目尚无产物规范时;已有自定义 docs/ 结构需形式化时;迁移至 AI Cortex 默认或 project-documentation-template 时。
限制:不得在未经确认时写入或覆盖规范文件;输出必须符合指定 schema;不负责完整文档引导(bootstrap-docs)、就绪度评估(assess-doc-readiness)或合规校验(validate-doc-artifacts)。