文档: 添加 AGENTS.md，记录清单 KB 结构和操作指南

AGENTS.md

+# 山东思达特问题清单 KB
+
+## 概览
+- **清单 ID**: sd-issue-list
+- **清单名称**: 山东思达特
+- **项目**: 山东思达特项目
+- **类型**: 问题清单（问题型 profile）
+- **ID 前缀**: ISS-山东-
+- **版本**: v1
+
+## Git 仓库
+- **地址**: http://118.31.18.126:9001/shanpenghui/sd-issue-list
+- **分支**: master
+- **认证**: 需要个人访问令牌（PAT）
+
+## 目录结构
+```
+sd-issue-list/
+├── list-config.md          # 清单宪法（字段定义、checklist）
+├── issues/                 # 问题对象（每个问题一个 .md 文件）
+│   ├── ISS-山东-000.md
+│   ├── ISS-山东-001.md
+│   └── ...
+└── 问题清单_看板.html      # 生成的 HTML 报告
+```
+
+## 字段映射（Excel → Ledger）
+| Excel 列 | Ledger 字段 | 说明 |
+|-----------|-------------|------|
+| 标题 | title | 问题标题（≤24字） |
+| 任务状态 | sap_status | SAP 状态 |
+| 具体任务 | title/desc | 问题描述 |
+| 负责人员 | owner | 责任顾问 |
+| 创建人 | raised_by | 提出人 |
+| 计划开始/完成时间 | plan_date | 计划日期 |
+| 解决方案 | plan | 当前方案 |
+
+## 状态派生规则
+```
+SAP=已取消, 验收=*       → 已关闭
+SAP=*, 验收=已驳回       → 进行中(返工)
+SAP=已完成, 验收=已验证  → 已完成
+SAP=已完成, 验收=待验证  → 待用户验证
+SAP=未开始, 验收=*       → 未开始
+SAP=*, 验收=*            → 进行中
+```
+
+## Checklist（状态转移门）
+| ID | 触发条件 | 门类型 | 检查项 |
+|----|----------|--------|--------|
+| chk-take-ownership | owner 变更 | soft | 需求沟通确认 |
+| chk-complete | sap_status→已完成 | soft | 测试确认 |
+| chk-dev | sap_status→测试中 | soft | FS文档就绪 |
+
+## 常用操作
+
+### 查看问题列表
+```powershell
+# 使用 bos-issue-ledger skill
+python "$LEDGER_SCRIPTS/list_issues.py" --mine
+python "$LEDGER_SCRIPTS/list_issues.py" --status 未开始
+```
+
+### 新建问题
+```powershell
+python "$LEDGER_SCRIPTS/new_issue.py" <kb目录> --json '{...}'
+```
+
+### 更新问题状态
+```powershell
+python "$LEDGER_SCRIPTS/update_issue.py" <kb目录> --id ISS-山东-XXX \
+  --sap 已完成 --acceptance 已验证 --log "进展说明"
+```
+
+### 生成 HTML 报告
+```powershell
+python "$LEDGER_SCRIPTS/render_html.py" <kb目录>
+```
+
+### 同步到 GitLab
+```powershell
+python "$LEDGER_SCRIPTS/remote_sync.py" <repo> <project> --branch master --cmd push
+```
+
+## 环境要求
+- Python ≥ 3.8
+- 依赖包: `pip install pyyaml openpyxl`
+- 环境变量: `LEDGER_SCRIPTS` 指向 bos-issue-ledger/scripts
+
+## 注意事项
+1. **不要直接编辑 issues/*.md 文件**，所有写入必须通过脚本
+2. **append-only 日志**：进展日志只能追加，不能修改历史
+3. **checklist 准入**：状态变更需要满足 checklist 要求
+4. **硬门失败**：状态不变，但尝试会留痕
+5. **软门失败**：状态变更，但会标记 escalate_sa
+
+## 当前问题统计
+- 总数: 12 条
+- 已完成: 11 条（ISS-山东-000 到 ISS-山东-010）
+- 未开始: 1 条（ISS-山东-011）