plan-tasklisted

# 设计技术方案 ## 行为边界 / 关键规则 - 本技能仅产出技术方案文档（`plan.md` 或 `plan-r{N}.md`）—— 不修改任何业务代码 - 这是一个**强制性的人工审查检查点** —— 不要自动进入实现阶段 - 执行本技能后，你**必须**立即更新 task.md 中的任务状态 版本戳规则：创建或更新 `task.md` frontmatter 时，先读取 `.agents/rules/version-stamp.md`，并写入或刷新 `agent_infra_version`。 ## 第 0 步：状态核对（执行前硬约束） 在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。 运行以下命令，并把原文粘贴到回复正文和本轮产物的 `## 状态核对` 段： ```bash git status -s ls -la .agents/workspace/active/{task-id}/ tail .agents/workspace/active/{task-id}/task.md ``` 状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。 ## 执行步骤 ### 1. 验证前置条件 检查必要文件： - `.agents/workspace/active/{task-id}/task.md` - 任务文件 - 至少一个分析产物：`analysis.md` 或 `analysis-r{N}.md` 注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022` 如果任一文件缺失，提示用户先完成前置步骤。 ### 2. 确定方案轮次 扫描 `.agents/workspace/active/{task-id}/` 目录中的方案产物文件： - 如果不存在 `plan.md` 且不存在 `plan-r*.md` → 本轮为第 1 轮，产出 `plan.md` - 如果存在 `plan.md` 且不存在 `plan-r*.md` → 本轮为第 2 轮，产出 `plan-r2.md` - 如果存在 `plan-r{N}.md` → 本轮为第 N+1 轮，产出 `plan-r{N+1}.md` 记录： - `{plan-round}`：本轮方案轮次 - `{plan-artifact}`：本轮方案产物文件名 ### 3. 阅读需求分析 扫描任务目录中的分析产物文件（`analysis.md`、`analysis-r{N}.md`）： - 如果存在 `analysis-r{N}.md`，读取最高 N 的文件 - 否则读取 `analysis.md` 以理解： - 需求及其背景 - 相关文件和代码结构 - 影响范围和依赖关系 - 已识别的技术风险 - 工作量和复杂度评估 ### 4. 理解问题 - 阅读分析中识别的相关源码文件 - 理解当前架构和模式 - 识别约束条件（向后兼容性、性能等） - 考虑边界情况和错误场景 ### 5. 设计技术方案 遵循 `.agents/workflows/feature-development.yaml` 中的 `technical-design` 步骤： **必要