feat(roles): 新增技能处理者角色,固化技能主文件只放默认路径的口径
新增 .dsh/roles/skill-custodian.md(双层结构:Agent Skills 三级加载 与官方体积约束 + 本仓 17 个技能现状盘点、12 条可判定审核清单、 改进四步流程、写域边界)。 口径固化三处,同一事实只详述一处: - AGENTS.md 铁律新增「技能写法」:主文件只放默认可用方案,按本项目 配好默认参数、一条命令能跑通、给出成功输出样例;失败时由脚本打印 稳定索引键,主文件按该键指向 reference/ 同名小节;排查细节、边界、 历史坑、手工兜底一律不进主文件。 - .dsh/roles/README.md:角色总览表、详细说明段、派活速查表各加一行, 角色计数 11 -> 12,并记录 worktree 新增角色不注入的实测坑。 - .dsh/roles/lead-orchestrator.md:分工表加一行。 实测:subagent_role 探针逐字回读 persona 首行与硬口径小节均命中; pre_commit 四文件全 Passed 零 Failed;BOM/CR/U+FFFD 均为 0。
This commit is contained in:
@@ -50,6 +50,7 @@
|
||||
- 改代码**只用 Edit 工具**;**绝不用 shell 重写含中文的文件**(乱码不可逆);**字符串字面量必须纯 ASCII**,中文只写注释。
|
||||
- **Edit 会剥 BOM**:带 BOM 文件编辑后须补回 → `bom-guard` 钩子自动拦截。带 BOM 名单(三处互指:本行、钩子 `files` 正则、`scripts/check_bom_drift.py` 的 `BOM_LIST`):`Drivers/BSP/UI/`(整目录)、`App/task/ui_task.c`、`App/cfg/cfg_file.c`、`Lib/lv_conf.h`
|
||||
- 行尾由 `.gitattributes` 写死 LF,**不依赖 `core.autocrlf`**;注释里别写星号形态的路径(ARMCC 9-D)→ `nested-comment` 钩子;`SKILL.md` 有 65536 字节写侧上限 → `skill-size` 钩子,深规程写进 `reference/`。规范全文 → `docs/代码规范/`。
|
||||
- **技能写法(`.dsh/skills/`)**:`SKILL.md` 主文件只放**默认可用方案**——按本项目配好默认参数、一条命令能跑通、给出成功输出样例;失败时由脚本打印**稳定索引键**(阶段名/退出码/报错前缀),主文件按该键指向 `reference/` 的同名小节。排查细节、边界、历史坑、手工兜底一律不进主文件。审核与改进 → `.dsh/roles/skill-custodian.md`。
|
||||
|
||||
## 提交门禁(pre-commit)
|
||||
|
||||
@@ -78,7 +79,7 @@
|
||||
|
||||
1. **Lead 只调度不执行**:拆解、分配、协调、判定、汇总。不直接做模块级实现——一旦自己动手,验收独立性就没了。
|
||||
2. **涉及两个以上模块,或需要构建+测试+文档联动 → Agent Teams**(`spawn_teammate` + `send_message`);单文件小改用 `subagent_role` 即可,不要为小活开团队。
|
||||
3. **角色绑定**:`spawn_teammate` 的 `prompt` **首行写 `@role:<角色id>`**(如 `@role:algo-specialist`),插件在子会话首轮请求组装前自动注入 `.dsh/roles/<角色id>.md` 的 persona 并应用工具白名单——**缺首行标记 = 无角色,勿省略**。`subagent_role` 路径同为自动注入。可用角色 → `.dsh/roles/README.md`(11 个)。
|
||||
3. **角色绑定**:`spawn_teammate` 的 `prompt` **首行写 `@role:<角色id>`**(如 `@role:algo-specialist`),插件在子会话首轮请求组装前自动注入 `.dsh/roles/<角色id>.md` 的 persona 并应用工具白名单——**缺首行标记 = 无角色,勿省略**。`subagent_role` 路径同为自动注入。可用角色 → `.dsh/roles/README.md`(12 个)。
|
||||
4. **派活必带验收口径**:任务书里写清「怎么算做对了」——可验证的结果定义 + 逐条检查清单 + 写域声明;回报必须附实测证据(命令输出、文件路径与函数名、计数),**不采信自述结论**。
|
||||
|
||||
**验收与返工**:验收人 ≠ 执行人(自证自验最容易掩盖真问题,**文档同理**);返工不许只回「收到」,须修正后附新证据重新提交。
|
||||
|
||||
Reference in New Issue
Block a user