目标
为 Agent 增加正式的 permission 字段声明和静态 Lint 校验,并通过 npm pack smoke test 确认 TDD skill 随包发布。
实现要点
Agent
permission字段解析 (src/plugin/agents.ts)AgentEntry增加permission字段解析capabilities仅用于 Lint 和文档校验- 将解析后的 permission 传递给 OpenCode config
Agent frontmatter 更新
backend.md/frontend.md:声明permission: {bash: "npm test|git push|...", write: ".worktree/", edit: "src/,test/,assets/"}— 不含 GitHub 写操作reviewer.md:声明permission: {bash: "gh pr view|diff|checks", write: deny, edit: deny}
prompt-lint 新增规则 (
src/plugin/prompt-lint.ts)- 检测 agent frontmatter 是否缺少
permission字段 - 检测 Worker 中是否有
gh pr create|merge等权限越界 - 检测
capabilities是否与permission一致 - 检测 Reviewer 是否声明了写权限
- 检测 agent frontmatter 是否缺少
npm pack smoke test
- 在
package.json添加test:pack脚本 - 验证打包后 tarball 包含
assets/skills/flow-tdd/SKILL.md
- 在
验收标准
- [ ] 4 个 agent prompts 均包含合法
permission字段 - [ ] prompt-lint 新规则通过 CI
- [ ]
npm packtarball 包含flow-tdd/SKILL.md - [ ] Agent 测试覆盖 permission 解析
Worktree
- 路径:
.worktree/tdd-a2-agent-lint/ - 分支:
feat/tdd-a2-agent-lint