From 0b1e10f2543022ba6022528c8594d591a8ffded9 Mon Sep 17 00:00:00 2001 From: super_agent_bot Date: Mon, 2 Nov 2026 13:30:40 +0800 Subject: [PATCH] docs: add kanban sync instructions for the agent --- AGENTS.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 97bcbe72..9f387fa5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -189,3 +189,23 @@ | 多任务并行开发（开空间 / 合并回收 / 台架与构建排队）；**DSH worktree 插件的仓内树怎么接上**（`.dsh-worktrees/` 缺 `.venv`、`plugin adopt`、锁归属 `pw:`） | **`task-worktree` skill**（`@task` 仅为文档别名非可执行命令，显式调用 `/task-worktree`，用到自动加载；插件桥 → 其 F 节）、`docs/环境与部署/并行任务工作树方案.md` §3.4 | | 换机 / 工具路径环境变量 | `docs/环境与部署/` | | 远程 CI（Gitea Actions，**只跑本机一台 runner**） | [`docs/CI/README.md`](docs/CI/README.md) | + + +## 看板同步（Gitea Projects，本仓库专用约定） + +本仓库配有一个看板「项目跟踪」（项目 id=3）。它的列名与问题标签同名：默认列 `Uncategorized`（不带标签的 Issue 在这），状态列为：已完成 / 进行中 / 下一顺位 / 排队 / 等外部资源 / 暂缓 / 观察 / 开放问题。 + +这台 Gitea（1.26.2）**没有 Projects REST API**（官方要到 1.28 才有），移卡必须调用服务机上的同步工具： + +``` +node C:/Users/67242/.dsh/sa-tools/card-sync.mjs [--to <列名>] [--dry-run] +``` + +规则： + +- 你改变了一个 Issue 的状态标签后（API 改标签正常），运行工具不带 `--to`：它会按标签把每个 Issue 放进同名列。标签与列名对不上时，用 `--to 列名` 强制指定列。 +- 不带标签的新 Issue 会落在 `Uncategorized` 列，这是正常的，不用管。 +- Issue 关闭不要移卡，直接关闭即可（关闭的 Issue 会自动离开看板列）。 +- 只碰这个仓库、这个项目；不要用它操作别的仓库的 Issue。 +- 运行后检查输出里的 moved/kept/skipped 汇总，异常时在你的回复里说明，不要静默忽略。 +- 用户问看板相关能力时，可以给出看板地址：http://gitea.bitnasdaq.vip/wandering1/STM32F4-Base/projects/3