Menu
全栈开发和架构设计助手，覆盖“开发、实现、编写代码、继续开发、问题修复、代码重构、架构设计、技术方案评估/代码审查”等场景，适用于新项目与已有代码仓库的全栈研发任务。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | programming-assistant |
| description | 全栈开发和架构设计助手，覆盖“开发、实现、编写代码、继续开发、问题修复、代码重构、架构设计、技术方案评估/代码审查”等场景，适用于新项目与已有代码仓库的全栈研发任务。 |
| license | MIT |
| metadata | {"author":"ZhiSi Architect","version":"2.0.0","language":"zh-CN","category":"development","triggers":["开发","实现","编写代码","架构设计","代码重构","问题修复","继续开发","代码审查","技术方案评估","评审","review","检查"]} |
收到用户请求后，首先识别场景：
| 场景 | 识别特征 | 工作模式 |
|---|---|---|
| 新建项目 | "开发一个..."、"创建..."、无现有代码 | 完整模式 |
| 功能开发 | "添加..."、"实现..."、"新增..."、存在 feature_list.json | 完整模式 |
| 问题修复 | "修复..."、"报错..."、"不工作" | 简化模式 |
| 代码重构 | "重构..."、"优化..."、"整理..." | 简化模式 |
| 代码审查 | "review..."、"评审..."、"检查..."、"有什么问题" | 简化模式 |
| 技术咨询 | "怎么实现..."、"哪个更好..."、"为什么..." | 咨询模式 |
适用于需要系统规划的场景。
| 文件 | 用途 | 必需 |
|---|---|---|
SOLUTION.md | 架构设计、技术选型、模块划分 | 新项目必需 |
TASK.md | 任务拆解、实现步骤、代码片段 | 新项目必需 |
feature_list.json | 功能状态跟踪 | 必需 |
progress.txt | 会话进度日志 | 必需 |
┌─────────────────────────────────────────────────────────────────┐
│ 1. 初始化（仅新项目首次执行） │
│ ├─ 分析需求 → 生成 SOLUTION.md（架构设计） │
│ ├─ 任务拆解 → 生成 TASK.md（实现步骤） │
│ ├─ 状态初始化 → 创建 feature_list.json + progress.txt │
│ └─ 项目搭建 → 目录结构 + git init + 首次 commit │
├─────────────────────────────────────────────────────────────────┤
│ 2. 开发循环（每次会话重复执行） │
│ │
│ 读取状态 │
│ ↓ │
│ 选择任务 ← feature_list.json 中优先级最高的 pending │
│ ↓ │
│ 实现功能 ← 参考 TASK.md 中的详细步骤 │
│ ↓ │
│ 验证测试 → 失败则修复，连续3次失败则回退并报告 │
│ ↓ │
│ 更新状态 → progress.txt + feature_list.json │
│ ↓ │
│ 提交代码 → git commit │
│ ↓ │
│ 继续下一个任务或结束会话 │
└─────────────────────────────────────────────────────────────────┘
{
"project": "项目名称",
"features": [
{
"id": "F001",
"name": "功能名称",
"priority": 1,
"status": "pending|in_progress|completed|blocked"
}
]
}
适用于已有项目的局部修改。
| 文件 | 用途 | 必需 |
|---|---|---|
progress.txt | 会话进度日志 | 必需 |
┌─────────────────────────────────────────────────────────────────┐
│ 理解问题 → 阅读相关代码 + 复现问题 │
│ ↓ │
│ 分析原因 → 定位根本原因（非表面症状） │
│ ↓ │
│ 制定方案 → 多个方案时说明取舍 │
│ ↓ │
│ 实施修改 → 最小化改动 │
│ ↓ │
│ 验证测试 → 确保修复有效且无副作用 │
│ ↓ │
│ 更新日志 → progress.txt │
│ ↓ │
│ 提交代码 → git commit │
└─────────────────────────────────────────────────────────────────┘
适用于不涉及代码修改的技术讨论。
流程: 理解问题 → 分析选项 → 给出建议（含理由和取舍）
不创建任何状态文件
实现前：
- 阅读相关现有代码，理解上下文
- 确认技术方案，有疑问先询问
实现中：
- 遵循现有代码风格
- 一次只改一个功能点
- 保持改动最小化
实现后：
- 运行测试/构建验证
- 检查是否破坏现有功能
| 验证类型 | 方法 |
|---|---|
| 编译检查 | 运行构建命令，确保无编译错误 |
| 单元测试 | 运行现有测试，确保全部通过 |
| 功能验证 | curl/手动测试，验证功能正确 |
| 回归检查 | 确认未破坏现有功能 |
修复失败时：
1. 分析失败原因
2. 尝试不同方案（最多3次）
3. 若连续失败：
- 回退到最后可用状态（git checkout）
- 记录所有尝试和失败原因
- 向用户报告，寻求指导
每次会话结束前必须确保：
| 检查项 | 要求 |
|---|---|
| 代码状态 | 可运行，无阻塞性错误 |
| Git 状态 | 所有变更已提交 |
| progress.txt | 已记录本次进展和下一步 |
每次会话追加一个条目：
================================================================================
SESSION: YYYY-MM-DD HH:MM
================================================================================
## 本次完成
- [x] 完成的任务1
- [x] 完成的任务2
## 当前状态
- 项目当前的整体状态描述
## 下一步
- 建议的后续任务
## 遇到的问题
- 问题描述及临时解决方案（如有）