用途:project-analyze 是纯观察型技能,用于理解项目代码库。它读取项目结构、检测技术栈、采样源码约定,并将观察到的结构与已记录的架构进行对比,把结果写入 analysis-report.md,同时更新 ai-context/ 文件中带 [auto-updated] 标记的区块。触发方式包括 /project-analyze、analyze project、project analysis、understand project codebase、codebase analysis,也被 project-audit 的 Phase A 扩展内部调用。
主要能力:第一步读取 openspec/config.yaml 的 analysis 配置,支持 max_sample_files(默认 20)、analysis_targets、exclude_dirs 等可选键;第二步以 manifest 优先方式检测技术栈,依次尝试 package.json、pyproject.toml、requirements.txt、pom.xml、build.gradle、go.mod、Cargo.toml、mix.exs、composer.json,找不到 manifest 时按文件扩展名采样推断;第三步用两层目录树映射结构,并分类为 monorepo、feature-based、layer-based、flat、mixed 或 unknown;第四步在采样上限内观察文件命名、函数与类命名、导入风格、错误处理模式;第五步与 ai-context/architecture.md 对比,标记 match、minor drift、significant drift;第六步写出 analysis-report.md 并合并更新 ai-context/ 区块。
使用方式:通过上述触发词调用。执行时最多使用 3 次 Bash 调用(步骤 1+2 共用 1 次,步骤 3 一次,步骤 4 一次),步骤 5、6 使用 Read 与 Write 工具。若 ai-context/ 不存在,只写 analysis-report.md,并提示先运行 /memory-init。
限制:绝不评分或给出严重级别,绝不生成 FIX_MANIFEST 条目,绝不修改 [auto-updated] 标记之外的内容,绝不创建 ai-context/ 目录,也不写 known-issues.md 和 changelog-ai.md。所有发现均为描述性内容。具体收费、价格与平台信息暂未提供。