| name | blas-new-op-workflow-maintain |
| description | 工作流维护技能。任何对 agent/ 目录下文件的新增、修改、删除操作，都必须先触发本技能再执行操作，包括修改本技能自身。禁止未触发直接修改。 |
blas-new-op-workflow 工作流维护指南
目录结构
仓库布局
ops-blas/
├── agent/ # 源文件目录（版本控制）
│ ├── AGENT.md # 主 Agent 配置
│ ├── README.md # 工作流概览
│ ├── QUICKSTART.md # 快速开始指南
│ ├── init.sh # 部署脚本
│ ├── agents/ # Subagent 定义
│ │ ├── developer.md
│ │ ├── tester.md
│ │ ├── reviewer.md
│ │ ├── architect.md
│ │ └── writer.md
│ └── skills/ # Skill 定义（每个子目录为一个 skill）
│ ├── blas-new-op-workflow/ # 主工作流 skill
│ │ ├── SKILL.md # 工作流主文档（硬规则 + 流程表）
│ │ ├── references/ # 流程参考文档（task-prompts / data-flow / error-handling）
│ │ └── assets/ # 模板文件（报告模板 *.md + CP 问卷 *.json）
│ ├── <skill-name>/ # 其他 skill（本地维护，由 init.sh 步骤 5 软链接）
│ └── cannbot_references.json # cannbot 外部 skill 引用映射
│
├── .opencode/ # OpenCode 运行时目录（init.sh 生成）
│ ├── AGENTS.md -> agent/AGENT.md
│ ├── agents/ # 软链接到 agent/agents/
│ └── skills/ # 软链接到 agent/skills/
│
├── .claude/ # Claude Code 运行时目录（init.sh 生成）
│ ├── CLAUDE.md -> agent/AGENT.md
│ ├── agents/ # 软链接到 agent/agents/
│ └── skills/ # 软链接到 agent/skills/
│
└── .agent/ # 临时工作目录（gitignore）
├── dev-docs/ # 开发过程文档
├── gitcode/ # PR/Issue 中间文件（gitcode-pr-issue-guide 生成）
├── cann-samples/ # 外部仓库（clone 或 symlink）
└── asc-devkit/ # 外部仓库（clone 或 symlink）
部署原理（init.sh）
agent/init.sh 负责将 agent/ 下的源文件部署到运行时目录：
| 步骤 | 操作 | 说明 |
|---|
| 1 | 创建 .opencode/ 或 .claude/ + .agent/dev-docs/ | 根据 target 参数选择，同时创建临时文档目录 |
| 2 | 软链接 AGENT.md | AGENTS.md -> agent/AGENT.md（opencode）或 CLAUDE.md -> agent/AGENT.md（claude） |
| 3 | 软链接 agents | .opencode/agents/*.md -> agent/agents/*.md |
| 4 | 设置 cannbot-skills | clone 或使用本地路径 |
| 5 | 软链接本地 skills | .opencode/skills/* -> agent/skills/* |
| 6 | 软链接 cannbot skills | 读取 cannbot_references.json，从 cannbot-skills 仓库软链接 |
| 7 | 设置外部参考仓库 | clone cann-samples 和 asc-devkit 到 .agent/ |
| 8 | 生成 opencode.json | 读取 model_config.json，将非 default 的模型配置写入项目级 opencode.json（仅 opencode） |
关键理解：
agent/ 是源文件目录，所有修改都在这里进行.opencode/ 和 .claude/ 是运行时目录，由 init.sh 通过软链接生成- 修改
agent/skills/xxx/ 后，如果已运行过 init.sh，软链接会自动指向新内容，无需重新运行
- 新增 skill 目录后，需要重新运行
bash agent/init.sh <target> 以创建新的软链接
cannbot_references.json
该文件定义了从 cannbot-skills 外部仓库引用的 skill：
{
"skill-name": ["path/in/cannbot-skills/repo"]
}
- key：skill 名称（在
.opencode/skills/ 中显示的目录名）
- value：在 cannbot-skills 仓库中的路径数组
注意：op-samples-reference 和 asc-devkit-reference 是本地 skill（在 agent/skills/ 中维护），不在 cannbot_references.json 中。它们由 init.sh 步骤 5 自动创建软链接，与 blas-log 等本地 skill 处理方式相同。
cannbot-skills 默认路径
init.sh 步骤 4 将 cannbot-skills 仓库 clone 到 $CONFIG_DIR/ref-repos/cannbot-skills（即 .opencode/ref-repos/cannbot-skills 或 .claude/ref-repos/cannbot-skills）。步骤 6 从该路径创建软链接到 .opencode/skills/。
修改操作指南
根据修改的文件类型，加载对应的参考文档：
所有修改完成后，必须执行 references/common.md 中的通用检查。
